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TERMS AND CONDITIONS OF SALE AND LICENSE OF RADIO SHACK COMPUTER EQUIPMENT AND SOFTWARE 
PURCHASED FROM A RADIO SHACK COMPANY-OWNED COMPUTER CENTER, RETAIL STORE OR FROM A 
RADIO SHACK FRANCHISEE OR DEALER AT ITS AUTHORIZED LOCATION 


LIMITED WARRANTY 


CUSTOMER OBLIGATIONS 


A. 


CUSTOMER assumes full responsibility that this Radio Shack computer hardware purchased (the ‘‘Equipment’’), and any copies of Radio 
Shack software included with the Equipment or licensed separately (the ‘‘Software’’) meets the specifications, capacity, capabilities, 
versatility, and other requirements of CUSTOMER. 

CUSTOMER assumes full responsibility for the condition and effectiveness of the operating environment in which the Equipment and Software 
are to function, and for its installation. 


RADIO SHACK LIMITED WARRANTIES AND CONDITIONS OF SALE 


A. 


C. 
D. 
Es 


For a period of ninety (90) calendar days from the date of the Radio Shack sales document received upon purchase of the Equipment, RADIO 
SHACK warrants to the original CUSTOMER that the Equipment and the medium upon which the Software is stored is free from manufacturing 
defects. THIS WARRANTY IS ONLY APPLICABLE TO PURCHASES OF RADIO SHACK EQUIPMENT BY THE ORIGINAL CUSTOMER FROM 
RADIO SHACK COMPANY-OWNED COMPUTER CENTERS, RETAIL STORES AND FROM RADIO SHACK FRANCHISEES AND DEALERS AT ITS 
AUTHORIZED LOCATION. The warranty is void if the Equipment’s case or cabinet has been opened, or if the Equipment or Software has been 
subjected to improper or abnormal use. If a manufacturing defect is discovered during the stated warranty period, the defective Equipment 
must be returned to a Radio Shack Computer Center, a Radio Shack retail store, participating Radio Shack franchisee or Radio Shack dealer 
for repair, along with a copy of the sales document or lease agreement. The original CUSTOMER'S sole and exclusive remedy in the event of 
a defect is limited to the correction of the defect by repair, replacement, or refund of the purchase price, at RADIO SHACK’S election and sole 
expense. RADIO SHACK has no obligation to replace or repair expendable items. 

RADIO SHACK makes no warranty as to the design, capability, capacity, or suitability for use of the Software, except as provided in this 
paragraph. Software is licensed on an ‘‘AS IS’’ basis, without warranty. The original CUSTOMER’S exclusive remedy, in the event of a 
Software manufacturing defect, is its repair or replacement within thirty (30) calendar days of the date of the Radio Shack sales document 
received upon license of the Software. The defective Software shall be returned to a Radio Shack Computer Center, a Radio Shack retail store, 
participating Radio Shack franchisee or Radio Shack dealer along with the sales document. 

Except as provided herein no employee, agent, franchisee, dealer or other person is authorized to give any warranties of any nature on behalf 
of RADIO SHACK. 

Except as provided herein, RADIO SHACK MAKES NO WARRANTIES, INCLUDING WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A 
PARTICULAR PURPOSE. 

Some states do not allow limitations on how long an implied warranty lasts, so the above limitation(s) may not apply to CUSTOMER. 


LIMITATION OF LIABILITY 


A. 


EXCEPT AS PROVIDED HEREIN, RADIO SHACK SHALL HAVE NO LIABILITY OR RESPONSIBILITY TO CUSTOMER OR ANY OTHER PERSON 
OR ENTITY WITH RESPECT TO ANY LIABILITY, LOSS OR DAMAGE CAUSED OR ALLEGED TO BE CAUSED DIRECTLY OR INDIRECTLY BY 
“EQUIPMENT” OR “SOFTWARE” SOLD, LEASED, LICENSED OR FURNISHED BY RADIO SHACK, INCLUDING, BUT NOT LIMITED TO, ANY 
INTERRUPTION OF SERVICE, LOSS OF BUSINESS OR ANTICIPATORY PROFITS OR CONSEQUENTIAL DAMAGES RESULTING FROM THE 
USE OR OPERATION OF THE ‘‘EQUIPMENT”’ OR ‘‘SOFTWARE’’. IN NO EVENT SHALL RADIO SHACK BE LIABLE FOR LOSS OF PROFITS, OR 
ANY INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY BREACH OF THIS WARRANTY OR IN ANY MANNER 
ARISING OUT OF OR CONNECTED WITH THE SALE, LEASE, LICENSE, USE OR ANTICIPATED USE OF THE ‘“‘EQUIPMENT”’ OR ‘‘SOFTWARE”’. 


NOTWITHSTANDING THE ABOVE LIMITATIONS AND WARRANTIES, RADIO SHACK’S LIABILITY HEREUNDER FOR DAMAGES INCURRED BY 
CUSTOMER OR OTHERS SHALL NOT EXCEED THE AMOUNT PAID BY CUSTOMER FOR THE PARTICULAR ‘‘EQUIPMENT”’ OR ‘‘SOFTWARE”’ 
INVOLVED. . 


RADIO SHACK shall not be liable for any damages caused by delay in delivering or furnishing Equipment and/or Software. 

No action arising out of any claimed breach of this Warranty or transactions under this Warranty may be brought more than two (2) years 
after the cause of action has accrued or more than four (4) years after the date of the Radio Shack sales document for the Equipment or 
Software, whichever first occurs. 

Some states do not allow the limitation or exclusion of incidental or consequential damages, so the above limitation(s) or exclusion(s) may 
not apply to CUSTOMER. 


RADIO SHACK SOFTWARE LICENSE 


RADIO SHACK grants to CUSTOMER a non-exclusive, paid-up license to use the RADIO SHACK Software on one computer, subject to the following 
provisions: 


B. 


Except as otherwise provided in this Software License, applicable copyright laws shall apply to the Software. 

Title to the medium on which the Software is recorded (cassette and/or diskette) or stored (ROM) is transferred to CUSTOMER, but not title to 
the Software. 

CUSTOMER may use Software on one host computer and access that Software through one or more terminals if the Software permits this 
function. 

CUSTOMER shall not use, make, manufacture, or reproduce copies of Software except for use on one computer and as is specifically 
provided in this Software License. Customer is expressly prohibited from disassembling the Software. 

CUSTOMER is permitted to make additional copies of the Software only for backup or archival purposes or if additional copies are required in 
the operation of one computer with the Software, but only to the extent the Software allows a backup copy to be made. However, for 
TRSDOS Software, CUSTOMER is permitted to make a limited number of additional copies for CUSTOMER’S own use. 

CUSTOMER may resell or distribute unmodified copies of the Software provided CUSTOMER has purchased one copy of the Software for each 
one sold or distributed. The provisions of this Software License shall also be applicable to third parties receiving copies of the Software from 
CUSTOMER. 

All copyright notices shall be retained on all copies of the Software. 


APPLICABILITY OF WARRANTY 


A. 


The terms and conditions of this Warranty are applicable as between RADIO SHACK and CUSTOMER to either a sale of the Equipment and/or 
Software License to CUSTOMER or to a transaction whereby RADIO SHACK sells or conveys such Equipment to a third party for lease to 
CUSTOMER. 

The limitations of liability and Warranty provisions herein shall inure to the benefit of RADIO SHACK, the author, owner and/or licensor of the 
Software and any manufacturer of the Equipment sold by RADIO SHACK. 


STATE LAW RIGHTS 


The warranties granted herein give the original CUSTOMER specific legal rights, and the original CUSTOMER may have other rights which vary 
from state to state. 
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Important Note! 


Be sure your Color Computer is turned OFF before 
you insert or remove the Disk Drive Controller Pak; 
otherwise, damage to the Color Computer or Pak (or 
both) may occur. 


Introduction 


The TRS-80® Disk Graphics program lets you plot a variety of charts and display them on the Color 
Computer Screen or print them on a graphics printer. 


With its multi-faceted chart-plotting capabilities, Disk Graphics has many practical, business, 
scientific, and engineering applications. 


And, with its easy-to-follow menus and prompts, Disk Graphics lets you draw very sophisticated 
charts (as well as chart “keys”) quickly and with a minimum of effort! 


System Requirements... 
To use Disk Graphics, you must have a: 


@ 16K (Radio Shack Catalog Number 26-3002) or 32K (26-3003) Color Computer which has Extended 
Color BASIC. 


@ Color television. 
@ Disk Drive and Disk Controller Pak™ (26-3022). 
@ COLOR TRSDOS 1.7 or later. 


Optional equipment includes a: 
@ Cassette Recorder. Needed for loading charts created with the ROM version of your program. 


e Printer. Disk Graphics can print charts on Radio Shack’s dot-matrix printers that have graphics 
capabilities and the Color Graphics Printer (26-1192). 


@ Additional Disk Drive (26-3023). 
About This Manual... 


In this manual, we'll: 

@ give you a brief overview of Disk Graphics. 

@ go through a quick “practice session” demonstrating how to draw a Vertical Bar Chart. 
@ discuss each type of chart. 

@ talk about displaying/printing. 

@ discuss chart Features. 

® tell you about saving and loading. 

Each type of chart has a separate chapter. If you only want to plot and display: 
e@ Pie Charts, read Chapters 1-5. 

e Bar Charts, read Chapters 1-4 and 6. 

e@ Line Charts, read Chapters 1-4 and 7. 

@ Key Charts, read Chapters 1-4 and 8. 

e Point Charts, read Chapters 1-4 and 9. 


We'll begin discussing Graphics right away and won’t be reviewing any Color Computer terminology 
or syntax. If you want to review, refer to your manuals, Getting Started with COLOR BASIC, 
Going Ahead with Extended COLOR BASIC, and Color Computer Disk System Owners 
Manual. 3 


~ 


Since Disk Graphics works in conjunction with your Printer (if you’re printing out copies of the charts a 
instead of just displaying them on the Screen), have your Printer’s owner’s manual handy as you read 
this manual. 


A Few Notes About the Program 


When any program is run under the control of COLOR TRSDOS, about 4K of RAM is required for 
COLOR TRSDOS, the text display buffer, and other system overhead. Disk Graphics needs about 7K of 
RAM for the graphic display buffer and other work space in RAM. 


If you add up the overhead, you will see that there is only about 5K left in a 16K Color Computer for 
the program itself. However, Disk Graphics contains over 16K of machine-language instructions. 


Disk Graphics gets around this problem by only loading into memory that part of the program it 
requires at any one time. Consequently, you’ll notice a slight hesitation as new parts of the program 
are loaded. (If you’re using a 32K Color Computer, you will not notice this since it can load more 
routines into memory.) This means that the Disk Graphics program diskette must remain in Drive 0 
at all times. Never remove the program diskette while using the program! 


The additional memory space a 32K unit has is used for an expanded printer buffer. Since the program 
can generate output for the Printer faster than the Printer can print it, this space is used to store 
printer output until the Printer can handle it. 


Work Files 


Disk Graphics allows nearly unlimited capacity for chart definition and features. However, since there =" 
is no room to keep this information in RAM, disk files are used to store chart data. Chart definitions , 
are kept in the files called DEFWORK1/WRK and DEFWORK2/WRK. As you define a chart, a copy of 

your keystrokes is saved in one of those files. When you revise a chart, it is read back and the new 

version is written to the other file. This flip-flopping takes place automatically. 


The features that are generated are stored in the file called FEAWORK/WRK. 


The minimum amount of disk space that can be allocated to a file is one granule, or nine sectors of 256 
bytes each. This is a total of 2,304 bytes of storage, more than enough for most definitions and sets of 
features. (Most definitions only require a few hundred bytes.) If you create a definition that requires 
more space than that, another gran (2,304 bytes) will be assigned to the work files. 


Once space is allocated to a work file, it remains allocated forevermore. This insures that you will 
always have enough work space for your “worst case” situations. If the files are expanded because of an 
unusual situation (such as trying to find out how many charts you can display at once), you can exit 
the program and KILL the work files. The next time you run Disk Graphics, the work files will be 
recreated with only one gran of allocated space. 


Disk Space Usage 


COLOR TRSDOS requires 4 granules on Drive 0, Disk Graphics uses 8, and the work files usually 
require 3. This is a total of 15 granules which leaves 53 available for saving your chart definitions, etc. 
Since most definitions use 1 gran, you could save as many as 53 charts on a single diskette. 


Definition and Feature Files 


Definitions and features are stored in your disk files differently than they are stored in work files. To 

make them compatible with BASIC, they require twice as many bytes of space. This means that you 

can save 1,152 bytes of features or definitions in a file of yours. This is still more than enough for most a, 
charts. (Larger files will require two or more grans of disk space.) 


1/ Getting Started 


Before you install your Disk System, you need to connect your Color Computer to the T.V. If you 
haven’t done it yet, refer to the TRS-80 Color Computer Operation Manual. Then connect the 
Disk System. 


Important Note: Your Computer must be OFF when you connect the Disk Drive Controller Pak or 
you could damage the Pak or your Color Computer. 


Powering Up 


After the system is set up: 

1. ‘Turn your T.V-ON. 

2. Select channel 3 or 4. 

3. Set the antenna switch on the T.V. to COMPUTER. 

4. Turn the Computer ON. (The power button is on the left rear side of your keyboard.) 
5. Turn the Disk Drive ON. 


When everything is turned ON, this message should appear on your TV: 
DISK EXTENDED COLOR BASIC wr. 

COPYRIGHT (C) 1981 BY TANDY 

UNDER LICENSE FROM MICROSOFT 

OK 

(u.r. is a pair of numbers specifying which version and release you have.) 


If not, turn the Computer OFF, check the connections, and power it up again. After powering-up the 
System, you can insert the Disk Graphics program diskette into Drive 0. (Be sure you don’t turn the 
System ON or OFF with the disk in the drive.) 


Now you're ready to begin. 


Load the Disk Graphics program by typing RUN "DOS" and pressing (ENTER). 


The yellow-and-red Main Menu of Disk Graphics will then appear on your Screen: 


7 


| 
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HHEKEEHKEKEKKKKEKHEKKEKEKKEKKKHHEHHKSKKKHKKKKHKHHE KEE 


DISK GRAPHIC 1.4 % | 
COPYRIGHT T3962 % 
ROBERT G. KILGUS % 
LICENSED TO TANDY CORP. * 
ALL RIGHTS RESERVED * 
* 


KKEKEKKKKEKEKKKEKKKKKEKKKKEKKKKEKKKKKKKKEKKKKKKHKKKHS 


CLEAR FEATURES 
CREATE A CHART 
LOAD INFORMATION 
SAVE INFORMATION 
EDIT FEATURES 
DISPLAY RESULTS 
XIT PROGRAM 
PRESS CHOICE NUMBER 
(BREAK OR ENTER FOR MAIN MENU) 


From this menu, you can start drawing charts. 


Oe as a eee 


2/ Program Overview 


Disk Graphics gives you the choice of plotting five different types of charts: 
e Pie draws a circular, “pie-shaped” chart that is divided into segments. 

e Bar draws a chart with vertical or horizontal bars. 

e Line draws a chart with points connected by a line. 


e@ Key used in conjunction with another chart (also called a “legend”), defines what each type of line or 
bar in the chart represents. 


@ Point draws a chart with two scales (one vertical and one horizontal). 


ACCOUNTING 


QUARTERLY SALES QUARTERLY SALES 


BUDGET 


2 


_ 
on 


ae PLASTICS 


pe 
—_ 
i=] 


WW STEEL 
[ _] LUMBER 


LS] 


- 
s 2 
z 3 
4 = 
< 


A 39% “RENT” 

B 17% “FOOD” 

C 26% “CAR UPKEEP” 
D 17% “OTHER” 


0 
JAN FEB MAR 
MONTH 


JAN FEB MAR 
MONTH 


Service 


Pie Vert. Bar Line Key Point 


Figure 1. Types of Charts 


Charts can be displayed/printed on: 

@ Color Computer Screen — low or high resolution. 

e Any Radio Shack dot-matrix printer that has graphics capabilities. 
@ Four-color Color Graphics Printer. 


A special feature lets you print extra-wide charts over two sheets of paper on a dot-matrix printer 
(which you can attach with cellophane tape). Another feature lets you print extra-tall charts over two 
sheets of paper on the Color Graphics Printer. 


Important Note: Never press RESET while using a Disk Graphics program diskette or work files will 
not be properly closed. 

Hints and Tips... 

Before you begin creating charts, here are some tips that will help you: 


e (ENTER) If you don’t know what to type next, press (ENTER). Disk Graphics usually supplies a “default 
value” for you. 


@ (REAK) to Main Menu If you press (BREAK) or (ENTER) a couple of times, you'll always be returned to 
the Main Menu. 


® Double-checks Disk Graphics always does a “double-check” before it begins printing or clearing 
information. 


® Defaults Disk Graphics has default numbers for many chart prompts. You have the choice of either 
using these or entering new values. 


@ Color Set Disk Graphics’ menus and prompts are displayed in yellow and red. Lowercase letters ued 
are red; uppercase letters are yellow, surrounded by red. Use (SHIFT to toggle between 
uppercase and lowercase modes. 


e Color Choices 0 is usually the default value for the color choice. For a low- or high-resolution 
Screen and the Color Graphics Printer, the range for Color is 0-3, but each number defines a 
different color. 


High-Resolution 
Low-Resolution Display and 
Display Graphics Printer Color Graphics Printer 


O red O black Depends on the position 
1 blue 1 dark gray of the pen. Usually: 


2 yellow 2 light gray 0, black; 1, blue; 2, 
3 green 3 green green; 3, red. All 
(Green is the (Green is the colors are visible. 
background color, background color, 

not visible.) not visible.) 


Table 1. Color Choices 


Errors 


When yov’re ready to display a chart, an error message might be displayed on your Screen. , 


These error messages are unique to the Disk Graphics program and do not apply to Color BASIC 
programs. 


After you have entered all the data to plot a chart, Disk Graphics does a self-check in memory (without 
displaying the chart on the Screen) to make sure the chart can be plotted and all titles fit on the chart. 
If the chart can’t be plotted, the message is printed on the Screen. For an easy solution, see Appendix 
A, Graphic Error Messages. 


Memory 


There are two types of data in memory: 
e Chart Definitions Prompts and values that define a chart. 


@ Features Internal instructions that describe a visual display in terms of the points, lines, boxes, 
arcs, and text strings from which it is made. (The internal “self-check” creates a set of features 
from the chart definition.) 


Definitions and Features are saved and loaded into memory independently and in different ways (see 
Chapter 12, Saving and Loading). 


SS er SS 5 


Before you proceed further: 
e Be sure your Color Computer and Disk System are properly connected. 


e@ From the Main Menu, clear features by pressing (1) (2); the Main Menu will appear and memory | 
will be cleared. There are seven choices on the menu. | 


In this example, you will draw a Vertical Bar Chart that plots the trading price over a five-month 
period for the fictitious automotive firm, Acme Motor Company. These are the monthly average 
trading prices of the stock: 


month dollars per share 


3/ Sample Session 


In this chapter you’ll get some “hands-on” experience in drawing a Vertical Bar Chart. 


These are the steps: 


in i. 


2. 


. Now there is a Screen full of prompts and the Cursor is at the position where you need to type in 


. You immediately get another Screen with more prompts. 


SS ee ee ee eee 


Since you want to create a chart, display the Main Menu and press: (2). 


The next menu asks if you want to revise a previous chart. Since you’re building this chart from 
scratch (and not revising), press: (2). 


This menu asks if it’s okay to clear the previous definition. Press: CL. 


The next menu gives you six choices for the type of chart you want to draw. Since you want a | 
Vertical Bar Chart, press: (2). | 


a name for your chart. Type: ACME MOTOR CO. STOCK. Press C1) five times and type: 
1 (ENTER) for SHADING. Use (SHIFT to type in uppercase mode. 


For SIDE LABEL, type: TRADING PRICE (this will be the label on the left side of the chart) 
and then press C{) once. The Cursor will be below BOTTOM LABEL. Now type: MONTH and press 
CY) once; the Cursor moves to the number of periods: 


PERTODS CQaeaeid 


To chart the price of the stock for five successive months, type: (5) (ENTER). 


. The next prompt asks you for the name of the first bar (NAME OF PERIOD @@@@1). Since you're 


charting months, make the first month JANuary (to save space on your charts, always use abbreviations). 


Type: JAN (ENTER). 


. This prompt asks for the name of the second bar. Type: FEB (ENTER). Repeat this procedure for 


MAR, APR, and MAY. 


. The next prompt asks you for the value of period 1 (JAN, the first month). This will be the 


JANuary trading price of Acme Motor Co. stock. Type: 38 (ENTER). 


10. This prompt asks you for the value of period 2 (FEB, the second month). Type: 44 (ENTER). Repeat wa 
this procedure for MAR (51), APR (41), and MAY (35). 


11. After you’ve entered all these values, you'll return to the Main Meau. Since you’ve entered all the 
required information for the chart, you can now display the chart on the Screen. To accomplish 
this, choose DISPLAY RESULTS from the Main Menu by pressing (6). 


12. You now get a display menu with six choices. Each choice represents the possible display site. 
Display the chart on the Screen in high resolution. Press: (2). Note: Refer to the Going Ahead 
with Extended COLOR BASIC manual for more information on low and high resolution. 


13. The last prompts are for the location of the display. Press and you'll get the default values. 


The Screen is changed to Graphics and the chart is drawn. Since you pressed 1 on Shading, each bar is 
shaded on the Screen in black. 


Even though there were a lot of steps in this procedure of drawing a chart, you’ll soon be breezing 
through each menu and prompt as you become more familiar with Disk Graphics. 


Size Reduction 


Now display the chart, but reduce its size: 

1. Press to get to the Main Menu. 

2. From the Main Menu, press: (6). 

3. From the display menu, press: (2). | a 
4. On the display prompts, press C}) twice. The Cursor moves to IMAGE SIZE REDUCTIONS. 

5. Press: C1) (ENTER). 


The display is drawn at one-half its original height and width. You can enter a value from 0 (full size, 
default) to 3 for the Image Size Reduction. Each value reduces the Screen in increments of 1/2. Press 
BREAK) to return to the Main Menu. 


Note: Resolution will decrease as images are reduced. 


1/2 
Reduction: 0 
y a Reduction: 1 
E a| Reduction: 2 
Reduction: 3 | - 
Figure 2. Image Size Reductions a | 


(For more information on Image Size Reductions, see Chapter 10, Displaying/Printing. ) 
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4/ Menus and Prompts for 
Entering and Changing Data 


The information provided in this chapter will explain how to input data to enter and change all types of 
charts (Pie, Bar, Line, Key and Point). Although each type of chart will be covered in detail in later 
chapters of this manual, the information in this chapter is basic to all of them. 


There are two methods by which Disk Graphics asks for information: 
@ Menus 


@ Data Prompts 


Menus 


A menu is a listing of “types” of charts, displays, etc., like the Main Menu: 


KH KKK KKK KKK KK KKK HK KEKE KKK KKH K KKK KKK KEK KKKKEKKKKEKEK 
* DISK GRAPHIC 1.4 % 
* COPYRIGHT 1982 x 
* ROBERT G. KILGUS % 
* LICENSED TO TANDY CORP. x 
* * 
* * 


ALL RIGHTS RESERVED 


KKKKKKHKKKEKKKKKKHKKRKEKKKRKKEKKKHKHKKKHKKHKHKKHKHKKKHKE 


CLEAR FEATURES 
CREATE A CHART 
LOAD INFORMATION 
SAVE INFORMATION 
EDIT FEATURES 
DISPLAY RESULTS 
XIT PROGRAM 
PRESS CHOICE NUMBER 
(BREAK OR ENTER FOR MAIN MENU) 
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You have seven choices in this menu, including Menu Selection: 6 — the Display Method Menu: 


DISPLAY METHOD? 
1, S36X126 4 COLOR 


B+ LTSZAZO6 . 2 bee 

3+ 999X480 B/W PRINTER 

4, B/W PRINTER (RIGHT HALF) 
>+ 488X999 4 COLOR PRINTER 
G+ COLOR PRINTER (UPPER 1/2) 


PRESS CHOICE NUMBER 
(BREAK OR ENTER FOR MAIN MENU) 


In this menu, you can choose 1, 2, 3, 4, 5, or 6, depending on the type of displaying/printing you want 
to do. Simply press the number and the command is accepted. If you make an invalid entry, Disk 
Graphics will cause the Computer to beep to indicate an error. 


Data Prompts 


Data Prompts are a series of prompts that are like a tax form — you must fill in each prompt or leave it 
blank if it’s not applicable. Once this “form” is completed, you press and the form is entered into 
memory. Be sure you don’t press until the entire form is completed the way you want it 
(although you can go back and edit the “form” later). 


When you answer Data Prompts, you fill in values to decide a line’s color, a chart’s size, if you want 
shading, etc. You can always tell a Data Prompt from a menu because prompts have a blinking cursor 
(which can be moved by pressing or (4.)). There are also bracketed areas on the Screen that indicate 
the areas where you can type. 


The ranges for prompts are not displayed on the Screen, but Disk Graphics will not accept any number 
which is not in the prompt’s range. For example, in a Pie Chart’s Data Prompts, if you press: (2) for 
shading, Disk Graphics will not accept the value and the input will be ignored (the range for shading is 
0-1). 


Some Data Prompts already have “default values”. The default values for a chart are: height (191) and 
width (255). (These dimensions set the chart to fill a high-resolution Screen.) Chart dimensions can be 
changed but if they are not, Disk Graphics uses 191 for the height and 255 for the width. 
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Chart Data Prompts 


To display the Chart Data Prompts, from the Main Menu press: (2) (2) CD) CD. These are the prompts 
you will see: 


CHART TITLE: 
4 


OVERALL CHART SIZE: 
HE TGHT Caeisgil 
WIDTH [CO@8255] 


CHART POSITION: 
UP [COOOOO] 
RIGHT [OOO00] 
SHADING 


ERASE 


CHART TITLE The alphanumeric text you enter here will be centered across the top of the chart. 
(Titles are not porportionally centered. If a title has an odd number of characters, the odd character is 
added to the left.) Disk Graphics prints the title as large as physically possible, as long as the title does 
not exceed 1/8 of the total chart height. The title must fit from left to right within the defined chart 
width. 


OVERALL CHART HEIGHT Disk Graphics has a default of 191 (the largest height that can be 
seen with the high-resolution Screen). You can enter any value up to 999. 


OVERALL CHART WIDTH Disk Graphics has a default of 255 (the largest width that can be seen 
with the high-resolution Screen). You can enter any value up to 999. 


CHART POSITION This indicates the location of the lower-left corner of the chart on the 999 x 999 
“Superscreen” (the Computer’s internal drawing pad). The numbers indicate how many points up and 
to the right on the Superscreen that the chart will be displayed. Zeroes are the defaults since Disk 
Graphics normally displays as much as it can of the Superscreen’s lower-left corner. 


SHADING Shading is the solid coloring of a pie section, bar, etc., and depends on the type of chart 
used and the type of color set used. The range is 0 to 1. “Zero” draws outlines only and is the default 
value. “One” shades in outlines. 


ERASE Erase is used when you want one chart to be placed on top of another (usually used with Key 
Charts, see Chapter 8). The range is 0 to 1. Note: If you use 1 for Erase, a box is drawn as big as the 
entire chart (whatever the chart’s dimensions are) and shaded in the background color. The rest of the 
chart is then drawn. Since the Color Graphics Printer does not “erase”, this command does not work on 
this Printer. 
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Labels/Periods Prompts 


Once the title, size, and chart location have been entered, the next Data Prompts display is the same 
for all charts except Pie Charts (since Pie Charts are circular). Even though the prompts look the same, 
the meaning of some of the data is different, depending on the type of chart you are building. 


The data to be evaluated is: 


SIDE LABEL 


BOTTOM LABEL 

[ 

PERTODS COOeO1] 
ITEMS/PERIOD COOdel) 
SCALE LINES bid 


SIDE LABEL The text you enter here is printed sideways up the left edge of the chart. 


Side 
Label 


Figure 3. Side Label on Vertical Bar Chart 
The Side Label is useful in adding notes to the scale of Vertical Bar, Line, and Point Charts, but it is 


not usually used for Key Charts. If a Side Label is not used, there is more room available to 
print/display the chart. (There is no Side Label with Pie Charts.) 
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BOTTOM LABEL The text you use for the Bottom Label is printed at the bottom of the chart. 


AMOUNT 


Bottom 
Label 


Figure 4. Bottom Label on Line Chart 


The Bottom Label is useful for adding notes to the scale of Horizontal Bar Charts and adding comments 
to Vertical Bar, Line and Point Charts. The Bottom Label can also be used for printing a centered line 
on a Key Chart. If you don’t use a Bottom Label, more space is available for the chart. (Pie Charts do 
not use Bottom Labels.) 


PERIODS Periods can be any number from 1 to 255. For Bar Charts, the number of periods is the 
number of groups of bars. You must enter a label for each group. For example, the periods (or groups) 
of bars on a Vertical Bar Chart are often labeled with a year or a day of the week. For Line Charts, 
periods indicate the number of points on each line. These periods are also usually labeled with a date or 
a year. For Key Charts, periods are the number of Key entries you want to use. For Point Charts, 
multiplying PERIODS and ITEMS PER PERIOD indicates the total number of points you want to plot. 


ITEMS PER PERIOD Items Per Period can be any number from 1 to 255. On Bar Charts, Items Per 
Period indicates the number of bars in each group. On Line Charts, it indicates the number of lines to 
be drawn on the same chart. Items Per Period is not used for Key Charts. 


SCALE LINES Disk Graphics automatically draws “Scales Lines” across Bar, Line, and Point Charts. 
The increments of the lines depend on the size of the chart and the chart’s data. The range for Scale 
Lines is 0 (no lines drawn) to 1, the default (Scale Lines drawn). If you do not want Scale Lines, enter 0. 


- 
= 
_ 
Oo 
= 
< 


Figure 5. Scale Lines on a Line Chart 
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Data Types Uo 


There are three types of data. Each prompt requires one of these “data types”: 


@ Text 
@ Single-digit Numbers 


@ Five-digit Numbers 
Text 


CHART TITLE: 
[ J 


Text is entered between the brackets and can be either numbers or letters. Here are a few tips to help 
— you enter text: 


@ Text is entered into the bracketed areas on a Data Prompt. 
e If you type new text over old text, the old text is erased (and the new text appears as you type). 
e erases incorrect letters. 


@ If you try to type too far (beyond the bracketed area), Disk Graphics causes the Color Computer to 
beep to indicate an error. 


@ Uppercase letters are yellow on a red background; lowercase letters are red on a yellow background. ~~ 


@ (SHIFT locks/unlocks the keyboard in uppercase letters. WwW 
Single-Digit Numbers 
SHADING CO] 


You can only enter numbers for the single-digit prompts. If you enter a letter, Disk Graphics causes 
the Color Computer to beep and the data is not changed. Depending on the prompt, you are limited as 
to how big the number can be. Disk Graphics never lets you enter an incorrect digit. For example, 
Color has a range from 0-3, inclusive. If you try to enter a value beyond 3, Disk Graphics will not 
accept the new value and will keep the old value on the Screen. 


Five-Digit Numbers 

CHART POSITION: CA2AAAO] 

Five-digit prompts are like single-digit prompts — you can only enter numbers. The size of the number 
depends on the range of that prompt (for example, the maximum range for any chart is the size of the 


Superscreen — 999 for the height and 999 for the width). In a few cases, 0 is not allowed (such as chart 
size). 


The Cursor always starts at the leftmost position on the prompt: 
[Qe234] 


Once you enter a number, the old number is replaced with the new number and the Cursor moves to 


the right: é 2 
[20001] ad 
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As additional digits are entered, the number shifts to the left Gust like on a calculator’): 
C22Ois] 


However, if you’ve entered a wrong number, press to erase the last digit typed: 
CAAOe01] 


If zero is not allowed for a prompt and you try to enter it, Disk Graphics causes the Color Computer 
to beep and the number remains the same. (Remember, no matter how hard you try, Disk Graphics 
will not let you enter a number beyond the range!) 


Once the form looks the way you want it, press (ENTER) (it doesn’t matter where the Cursor is currently 
located). 


Editing 

Disk Graphics has very powerful editing capabilities that let you load a chart file into memory and 
change some of the information in the chart definition file. 

You'll use editing when you: 

@ are defining a chart for the first time 

@ want to edit a chart that’s currently in memory 


The editing keyboard functions are listed in Table 2. 


a 


see 


— Moves Cursor up the Data Prompts. 


ee J 


— Move 


es e 


= Sees z Bee 


— Enters the editing changes into memory and 
moves to the next menu/Data Prompts. 


sec ace 


see 


ee 
SS 


Table 2. Editing Symbols 


Tips on Editing: 


e Cursor The Cursor is placed at the bottom of each display when you edit. If you want to change an 
item, use (4) to move to the item you want to change, change it, and then press (ENTER). 


@ No changes If you do not want to change anything on a display, press (ENTER) and the next display 
will appear. 


+7 


@ Shortcut Once you have made a change and don’t want to change anything else, press (BREAK). The a, 
remaining displays will “flash by” and then the Main Menu will appear. (Exception: If you change 
the number of sections in a pie or the number of periods or items on Bar, Line, Key, or Point Charts 
to a higher number, Disk Graphics stops and waits for you to enter the additional information for 
these sections, periods, etc.) 


Sample Session 


To get you better acquainted with Disk Graphics’ editor, run through a practice session (be sure to 
first clear features): | 


1. Display the Main Menu and press: (2). 

2. On the REVISE PREYIOUS CHART prompt, press: (2) CLD. 

3. From the TYPE OF CHART menu, press: (1). 

4. You're now in the first series of Data Prompts for this chart. Move the Cursor down the Data 
Prompts with Cy), and then up the Data Prompts with C4). 

5. Move the Cursor to the CHART TITLE prompt and type: GROSS PROFIT MARGIN. 

6. Move the Cursor to the next line with (1). On this line (QVERALL CHART SIZE: HEIGHT), 
there’s a default of 191. To change this to 00000, press: (0). To change this line back to the default 
value, type: 195. Since this number is incorrect, press: one time and then press: (1). 

7. Move the Cursor back up to the chart’s title and press (SPACEBAR). The chart’s title is erased. 

8. Turn the volume on your TV up halfway. Move the Cursor all the way up the display and then all 
the way down with (4) and CY), respectively. Disk Graphics causes the Color Computer to beep 
when the Cursor cannot proceed further. 

9. Press three times and you’re back at the Main Menu. 


Superscreen WY 


Disk Graphics has a “Superscreen” that has 999 addressable points horizontally and 999 addressable 
points vertically. This Screen is helpful because it lets you draw particularly wide and tall charts. 


A chart can be drawn anywhere on the Superscreen (the range for a chart’s height is 1 to 999 and the 
range for a chart’s width is 1 to 999). A chart’s height is on the (vertical) Y-axis and the width is on the 
(horizontal) X-axis. 


(0,999) (999,999) 


(256,192) 


High-resolution 
Color Computer 
Screen 


Y-axis/height 
(vertical) 


(0.0) (99,0) Nad 


X-axis/width 
(horizontal) Figure 6. Disk Graphics’ Superscreen 
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te 


To avoid confusing these points with Color Computer Screen pixels, we’ll call them “Superscreen 
Points”. 


Charts can be moved up and to the right on the Superscreen. 


(0,999) (999,999) 


“Superscreen’ 


Moved up 
and to the 
right on 

Superscreen 


(0,0) (999,0) 


Figure 7. Moving a Chari 
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5/ Pie Charts 


A Pie Chart compares parts to a whole and is particularly effective when you’re comparing a small 
number of items. It is a circular “pie-shaped” chart that is divided into sections. Each “slice” of the pie 
represents a percentage of the “total pie”. The size of each section is proportional to the percentage of 
the total pie represented by that section. 


A pie’s section descriptions are located at the right side of the chart. The descriptions have either 
lettering or lines identifying each section. 


A 28% RENT 


28% RENT 


Figure 8. Pie Section Identification 


Pie sections are alphabetically lettered counterclockwise, starting with “A”. The percentage 
descriptions of each section are listed at the right side of the chart. 


ABC SHOE CO. FEB SALES 


Lettered 
Counterclockwise 


A 28% CASUAL Pie 

B 22% ATHLETIC Section 

C 21% BOOTS Descriptions 
D 16% DRESS SHOES 

E 13% HOUSE SHOES 


Figure 9. Pie Chart 


Every time you power-up Disk Graphics, the Main Menu is displayed. To create a Pie Chart, select 
Menu Selection (2) (CREATE A CHART). The “Pie Chart Features” you enter (how many sections, 
the values for those sections, color, etc.) to the chart prompts are compiled as you proceed. The final 
format of the sections of the pie are determined by the values you enter in the chart definition. 


Sample Session 


Draw a Pie Chart for a monthly budget. These are the expenses: 


rent $250 
food $138 
car upkeep $206 
miscellaneous $177 
entertainment $ 80 

$851 total 


As with any budget, you’d like to know how much (percentage-wise) you are spending a month for 
these items. A Pie Chart, which displays sections and percentages, is a perfect way to find out. 


Clear features and then answer the prompts to draw a Pie Chart for this budget: 


1. 


10. 


Display the Main Menu and press: (2). 


2. Onthe REVISE PREVIOUS CHART prompt, press: (2) C1). 
3. From the TYPE OF CHART menu, press: (1). 

4. 
D 


For the CHART TITLE prompt, type: BUDGET (ENTER). 


. There are five sections or “slices” (rent, food, car upkeep, miscellaneous, and entertainment), so for 


the NUMBER OF SLICES prompt, type: (5) (ENTER). 


. Now you are ready to enter the values for each section. The first PIE SLICE SIZE prompt is for 


Pie Section (slice) number 1, rent. Type: 25@. Move the Cursor down to DESCRIPTION and 
type: RENT (ENTER). 


. Anewsetof PIE SLICE SIZE prompts is now displayed. This second set of prompts is for Pie 


Section 2, food, so type: 138. Move the Cursor down to DESCRIPTION andtype: FOOD (ENTER). 


. This next set of prompts is for Pie Section 3, car upkeep, so type: 2@6. Move the Cursor down 


to DESCRIPTION andtype: CAR UPKEEP (ENTER). 


. The fourth set of PIE SLICE SIZE prompts is for Pie Section 4, miscellaneous expenses. 


@ Type: 177. 

@ Move the Cursor to SHADING EXCEPTION and type: 1. 

@ Move the Cursor to OFFSET and type: 12. 

@ Move the Cursor to DESCRIPTION andtype: MISCELLANEOUS (ENTER). 


The last set of prompts is for Pie Section 5, entertainment, so type: 8@. Move the Cursor down 
to DESCRIPTION andtype: ENTERTAINMENT (ENTER). 


After entering this last value, you are back at the Main Menu. Press: (6) (DISPLAY RESULTS). From 
the next menu (DISPLAY METHOD?), press: (2). On the next prompts, press (ENTER). 
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The chart is drawn on the Screen in high resolution. Pie section D, representing miscellaneous 
expenses, is offset from the other sections and shaded in black. The pie sections have alphabetical 
numbering: 


@ Rent (section A) is 29% of the total monthly budget. 
@ Food (section B) is 16% of the total. 

@ Car upkeep (section C) is 24% of the total. 

@ Miscellaneous (section D) is 21% of the total. 

e@ Entertainment (section E) is 9% of the total. 


The total percentage of this example (29+ 16+ 24+21+9) is 99%, rather than 100%. Disk Graphics 
always rounds off percentages to the nearest integer, so the percentage total for many pie charts is 
99%. For example, these are the percentages to two significant digits for your budget program: 


rent 29.38% (rounded to 29%) 
food 16.22% (rounded to 16%) 
car upkeep 24.21% (rounded to 24%) 
miscellaneous 20.80% (rounded to 21%) 
entertainment 9.40% (rounded to 9%) 
total 100.01% (total of rounded 


values is 99%) 


Resolution 


Display this Pie Chart now in low resolution (96 x 128). (First, press (BREAK) to return to the Main Menu.) 
1. From the Main Menu, press: (6). 
2. For a four-color low-resolution Screen, press: C1). 


3. On the next set of prompts, press (ENTER) and the pie chart is displayed. Note that Pie Section D is 
now shaded in red. Since you’re in low resolution, you can only see the lower-left corner of the Pie 


Chart. 


To display the entire Pie Chart in low resolution, you'll have to reduce the size of the chart (Image Size 
Reductions). To do this: 


1. Press (BREAK) and you’re back at the Main Menu. 
2. Press: (6). 

3. From the display menu, press: (1). 

4 


. Press twice and type: C1) (ENTER). The four-color display now fits perfectly on the Screen — 
however, with less resolution. Note that the high-resolution text may not be readable in this 
lower-resolution mode. This mode is primarily used for color selection. 


5. Press (BREAK) to return to the Main Menu. 


Note: If you want to view your chart in low resolution, you can define your chart as being 95 high by 
127 wide. (You may need to shorten some descriptions.) If you reduce the dimensions of the chart in 
the chart definition, you will not need to use Image Size Reductions. The chart will just fit on the 
Screen, and the images will be much clearer than they would be if you used the Image Size 
Reductions feature of Disk Graphics. 
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Important Prompts ad 


Look at some of the important prompts in the Pie Chart program. After you enter the chart title, you 
will see prompts for three items: 


NUMBER OF SLICES C2A0e01) 
PERCENT (@=NO;1=YES) tid 
REF. (@=LINES+1=LABELS) [1] 


NUMBER OF SLICES You have to enter a number and description for each section. The maximum 
number of sections allowed is 255, but the physical maximum depends on how big you make your 
chart (smaller charts have less space for describing multiple sections). Disk Graphics is extremely 
accurate — it can draw pie sections to an accuracy of one degree! 


You can enter over 80 sections on a chart that is 999 points high, but that would look extremely 
congested. You’ll find that Pie Charts look well-spaced and uncluttered when you have 8 or less 
sections. More than 26 slices is not recommended since special characters will be generated as 
reference letters. 


PERCENT There are two choices for percentages — yes or no (1 or 0, respectively). By entering yes - 
(the default), Disk Graphics calculates the percentage of the total pie that each section represents and 
displays it as a part of the section’s description: \ 


28% RENT 


Percentage is accurate to 1 percent and is rounded. If you do not want percentages shown, change the 
percent to 0: 


RENT | 


REFERENCE Reference prints a letter in the middle of each pie section and to the left of the section’s 
description: 


A 28% RENT 


Reference can be either 0 or 1 (1 is the default). If reference is 0, a line is drawn from each section’s 
description to the pie section descrgbed: 


| 
28% RENT 
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The next Data Prompts are these: 


rit Sie 

S12: COOAa1 I 
COLOR CO] 
SHADING EXCEPTION CO] 
OFFSET C8200] 
DESCRIPTION 

[ J 


SIZE This is the value (and thus the “size”) you want each pie section (slice) to be. The range is 1 to 
30,000. You can enter any whole number and the number is converted to a percentage of the pie by 
Disk Graphics. In the Pie Chart for the monthly Budget, 250 is converted to 29% RENT (depending 
on the totals of the entire pie). If you already know the percentages or degrees, you can enter them as 
long as the total of all sections is 100 percent or 360 degrees. 


COLOR The range for Color is 0 to 3. You’ll have to decide how you're going to display your Pie Chart 
before you enter the value for Color because different “displayers” (high- or low-resolution Screen and 
printers) have different color sets (see Chapter 2, Program Overview). Since dot-matrix printers are 
black-and-white, Color works as “shading.” All four colors are visible on the Color Graphics Printer 
but only three are visible on the Color Computer Screen (all but the background color). 


SHADING EXCEPTION Shading Exception determines if a particular pie section is shaded and is 
either 0 or 1. Shading Exception “takes exception to” the Shading for the total pie: 


Shading Shading Exception Action on Pie Section 


a | 1 no shading 


Table 3. Shading/Shading Exception 


Normally all sections are shown only as an “outline”, but with shading, the section is filled in with the 
specified color. 


Figure 10. Shading 
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OFFSET This variable tells how many Superscreen Points from the center of the pie to set off (or ad 
“offset”) the pie section. Each section can be moved up to 250 points away from the center (0 is not 
offset). You’ll want to use Offset when you want a predominant section to stand out from the others. 


IS) AIS 


Figure 11. No Offset Sections Figure 12. One Offset Section 


DESCRIPTION This is the name of each section. Be as brief as possible. Descriptions will be as large 
as possible as long as they do not use more than 1/2 the width of the chart. Three- or four-letter 
abbreviations (FRI, JAN, AUTO, etc.) are a good length. Descriptions are displayed to the right of the 
Pie Chart. 


The starting location for printing these labels is a point 3/4 of the radius outward from the center of the | 
circle along a line that bisects the arc of the slice. This locus represents the lower-left corner of the dot w/ 
matrix of the description’s first letter. As a result, the label is generally upward and to the right of that 

point. 


The program keeps track of the smallest slice size. If a slice is less than 32 degrees, a text size 1/2 as 
large as normal is used for the labels. 


A Pie Chart’s diameter depends on how much height is available below the title, the width of the chart 
and the longest section description. 


? 


Title 


BUDGET 


Pie — A 28% RENT 
aes B 22% FOOD 
Sections ; C 21% CAR 
D 15% ENTERTAINMENT 
E 13% MISCELLANEOUS 


Section 
Descriptions 


Figure 13. Locations on Pie Chart 
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Self-Check 


After you have entered all the data for each section, Disk Graphics does a “self-check” (without 
displaying the chart on the Screen) to see if all the data will fit on the chart so a chart can be drawn. 
(It is attempting to generate features.) If a chart can be drawn, you will be returned to the Main 
Menu after the self-check. If there’s a problem, the Screen is cleared, the error number is displayed 
and a one- or two-line description of the error is shown. For an easy solution, refer to Appendix A, 
Graphic Error Messages. 
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6/ Bar Charts 


In this chapter we’ll discuss the two types of bar charts: 
@ Vertical 


@ Horizontal 


SALES 


MONTH AMOUNT 


Figure 14. Vertical Chart Horizontal Chart 


Both types of charts may have either one item of data per period or multiple items of data per period. 


AMOUNT 


AMOUNT 


Figure 15. One-Group Vert. Chart Three-Group Hor. Chart 


Both types of bar charts have the same principle, except: 


@ Titles reversed The bars in a Vertical Bar Chart are drawn from top to bottom (vertically) while 
the bars in a Horizontal Bar Chart are drawn left to right (horizontally). Consequently, the titles on 
the side and bottom of the charts are reversed. 


@ Title size You can use longer titles on the side of a Horizontal Bar Chart because the titles are 
displayed horizontally (not “end-to-end” like onVertical Bar Charts). The longer the titles, the more 
compressed the bars are; the shorter the titles, the more elongated the bars are. You might want to 
use a Vertical Bar Chart when your titles are very brief and you don’t need the extra room as when 
youre using years (80, 81, etc.) or numbers (1, 2, etc.). 
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SALES 


Vertical title 


Year (fall term) 


4 6 8 


AMOUNT 


10 


Horizontal title 


Figure 16. Titles 


Bar charts point out individual values and are effective for item-to-item comparisons. The size of each 
data value is indicated by the length of the bar, measured against the vertical or horizontal scale. Bar 
charts can also show variance — such as plan versus performance, or this year’s sales versus last 
year’s. Bar charts are helpful to use when you want to easily see the differentiation of the values that 
compose the bars. The thick bars (as opposed to points in a Line Chart) help the data really stand out, 
especially if you use shading as a “highlighter” for one or more of the bars. 


Look at some of the bar prompts: 


VALUE Value can be any number from 1 to 30,000. The values on a chart determine how wide or tall 
the bar will be. 


HIGHER 
VALUE 


Figure 17. Values 


Bars are automatically scaled by Disk Graphics so that the largest value entered is as tall and wide as 
physically possible. 


COLOR Disk Graphics automatically assigns different colors to the bars within each multi-bar group, 
but you can assign the colors yourself. 


SHADING EXCEPTION Disk Graphics prints/displays alternating shaded and unshaded bars in a 
group; however, you can “override” this using Shading Exception. 
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One-Group Vertical Bar Charts 


Plot a one-group Vertical Bar Chart for the fall enrollment of State University over a seven-year period 
(1976-1982). Because of a 25% tuition increase for the fall term of 1979, enrollment for that session 
dropped drastically — below 20,000. 


These are the enrollment figures: 
22,066 1976 
22,651 1977 
21,573 1978 
19,879 1979 
22,326 1980 
23,780 1981 
25,022 1982 
To draw the chart: 
1. First, clear features. 
Display the Main Menu and press: (2) (2) C1). 
For the TYPE OF CHART prompts, press: (2). 


. Type the Chart Title in uppercase letters: STATE U. ENROLLMENT. Press (ENTER 


oF © 


. Enter the labels in lowercase letters. For the Side Label, type 
Bottom Label, type: * 
of bars in the chart) press: 


CENTER). 
6. Next comes the name for each bar (period). The first bar is the first year of our chart (1976). 
@ For the name of period 1, type: 76 (ENTER). 
@ For period 2, type: 77 (ENTER). 
e For period 3, type: 78 (ENTER). 
@ For period 4, type: 79 (ENTER). 
@ For period 5, type: 8@ (ENTER). 
For period 6, type: 81 (ENTER). 
e@ For period 7, type: 82 (ENTER). 
7. Next comes the value for each bar (the number of students enrolled in each fall term). 
@ For the value of period 1, type: 22066 (ENTER). 
@ For period 2, type: 22651 (ENTER). 
e@ For period 3, type: 21573 (ENTER). 


e For period 4, type: 19879. Since this was a particularly bad year for enrollment, shade this bar 
so it stands out. Move the Cursor down to Shading Exception and press: (1) (ENTER). 


@ For period 5, type: 22326 (ENTER). 
@ For period 6, type: 23782 (ENTER). 
@ For period 7, type: 25022 and you're back at the Main Menu. 
Now display the results on your Screen in high resolution. The bar for 1979 is shaded in black. 


Multi-Group Vertical Bar Chart 


To see an example of a multi-group chart, plot the monthly profit increases over last year for three 
companies owned by Acme Inc. The figures are: 


Retail Div. Steel Div. Plastics Div. 
Jan 11 9 7 
Feb yee 13 18 
Mar 4 2 8 


There are three periods in this chart (Jan, Feb, and Mar) and three items in each period (retail div., 
steel div., and plastics div.). Enter the values for this chart: 


1. First, clear features. 

2. Display the Main Menu and press: (2) (2) C1). 

3. For the TYPE OF CHART prompts, press: (2). 

4. Type the title of the chart in uppercase letters: ACME INC. MONTHLY PROFITS. Press (ENTER). 
5 se letters. For the Side Label, type: PE 


. Enter the labels in lo 
Bottom Label, type 


— 


Since there are three months, for the periods type: 3. 
7. Forthe ITEMS/PERIOD prompt, type: 3 (ENTER). 
8. Next comes the name for each bar (period). 
Name of period 1: JAN. 
Name of period 2: FEB. 
Name of period 3: MAR. 
9. Now comes the value of each item in each period. 
Value for period 1, item 1: i1. 
Value for period 1, item 2: 9. 
Value for period 1, item 3: 7. 
Value for period 2, item 1: 15. 
Value for period 2, item 2: 13. 
Value for period 2, item 3: 18. 
Value for period 3, item 1: 4. 


MJ 


Value for period 3, item 2: 
Value for period 3, item 3: 8. 


Now display the results on the high-resolution Screen. You'll notice that Disk Graphics has assigned a 
different color to each bar and automatically alternated the shading. 


Note: A Key Chart can be added later to distinguish one division from another (see Chapter 8). 
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Horizontal Bar Charts 


The Side and Bottom Labels on a Horizontal Bar Chart are “reversed” when compared to a Vertical 
Bar Chart. 


For an example of a Horizontal Bar Chart, chart the trading price of one ounce of silver over a 
one-week period. We’ll assume for the following fictitious prices that there was a great deal of 
speculation by buyers during the week and the price fluctuated wildly. 


Here are the opening trading prices for each day: 


Monday $34.50 
Tuesday $39.50 
Wednesday $46.47 
Thursday $34.18 
Friday $29.56 


To plot the chart, follow these steps: 

1. First, clear features. 

2. Display the Main Menu and press: (2) (2) CL. 
3. From the TYPE OF CHART menu, press: (3). 


4. Enter the values in the same way as you entered them for a Vertical Bar Chart. Name the chart in 
R TRADING PRICE. Name th tters. For the Side 
Label, type: for the Bottom Label, type : 


5. There are five periods (five days in a week), so for PERIODS, press: (5) (ENTER). 


6. Now, name each bar. You can enter the full name of each day of the week. 
@ Monday 
@ Tuesday 
@ Wednesday 
e Thursday 
e Friday 


7. Next enter the value for each bar. (Note: When using decimal point values, such as percentages, 
monetary values, etc., you’ll have to enter the values without decimal points. For instance, $34.50 is 
entered as 3450.) 


@ 3450 for Monday 
@ 3950 for Tuesday 


@ 4647 for Wednesday — Since Wednesday’s opening price was exceptionally high, shade this 
bar (for Shading Exception, enter: (1)). 

@ 3418 for Thursday 

@ 2956 for Friday 
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igh resolution on your Screen. When displayed, you'll see the Bottom Label 
) has increments of 2000 and 4000. Since we can’t enter decimals (the dollar 
nts represent how many pennies (rather than dollars) the silver costs per 


ounce. 


Note: Edit Features can be used to insert decimal points. 


Display the chart now in low resolution. In addition to the background color, green, you'll have three 
other colors to work with: yellow, blue, and red. 


Do some editing to take advantage of these colors: 
1. Return to the Main Menu and press: (2). 
2. From the REVISE PREVIOUS CHART? prompt, press: C1). 


3. Now you're back into the Horizontal Bar Chart (SILVER TRADING PRICE) which you just 
created. Change Shading to (1). Press (ENTER) eight times. 


4. You’re now in Period 2. Move the Cursor up to Color and press: (2) (ENTER). 


5. For Period 3, change Shading Exception back to (0). Then move the Cursor up to Color and press: 
CD (ENTER) (ENTER). 


6. For Period 5, move the Cursor up to Color and press: (3_) (ENTER). You’re now back at the Main Menu. 


7. Press: (6) to display results. For low resolution, press: (1). To reduce the image, move the Cursor 
to IMAGE SIZE REDUCTIONS and press: C1) (ENTER). 


The Horizontal Bar Chart is drawn on the Screen. Bar 1 (Monday) is shaded in red, bar 2 (Tuesday) is 
shaded in yellow, bar 3 (Wednesday) is shaded in blue, bar 4 (Thursday) is shaded in red, and bar 5 
(Friday) is “invisible” because it is shaded in the background color, green. 


Display the chart (with the current shading) in high resolution: 
1. Return to the Main Menu and press: (6). 


2. From the Display Menu, press: (2) (ENTER). The chart is displayed. Bar 1 is shaded in black, bar 2 is 
shaded in light gray, bar 3 is shaded in dark gray, bar 4 is shaded in black, and bar 5 is shaded in 
the background color again, green. 


3. Press (BREAK) to return to the Main Menu. 
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7/ Line Charts 


A Line Chart shows how data changes over time, and illustrates the continuous flow of change. The 
emphasis is on trends over a series of days, months, or years. Each time period on the Chart’s 
horizontal scale is associated with a data point whose value is measured on the vertical scale. A Line 
Chart is a graph of points (values) connected by a line. With Disk Graphics, you can draw either single- 
or multi-line (used for easy comparison) charts. 
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Single-Line Charts Multi-Line Charts 
Figure 18. Line Charts 


All lines in a Line Chart have a point in the first period, followed by a line that connects a point in the 
next period to the first period point, followed by a line that connects a point in the next period to the 
second period point, etc. 


Figure 19. Large Points 


Single-Line Chart 


Plot the daily high temperature over a one-week period in St. Louis. 


These are the temperatures: 


Monday 63 
Tuesday 50 
Wednesday 39 
Thursday 33 
Friday 44 
Saturday 59 
Sunday 55 
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Enter these for the prompts: 


CHART TITLE: 


i type: 


DAILY HIGH TEMPERATURE 


SIDE LABEL: TEMPERATURE 
BOTTOM LABEL: DAY 
PERIODS: Z 
NAME OF PERIOD QAAO1: MON 
NAME OF PERIOD QABO2: Poe. 
NAME OF PERIOD OAAO3: WED 
NAME OF PERIOD QAAOd: THU 
NAME OF PERIOD Q2BAOS: FRI 
NAME OF PERIOD QAAGG: SAT 
NAME OF PERIOD QAO07: SUN 
POINTS: 

COLOR: @ 

oLz2e% yd 
VALUE FOR PERIOD @@001: 63 
VALUE FOR PERIOD @00@2: 2 
VALUE FOR PERIOD ®00@3: 30 
VALUE FOR PERIOD #0004: 33 
VALUE FOR PERIOD @00@5: 4a 
VALUE FOR PERIOD #8006: oo 
VALUE FOR PERIOD 80007: = 


Display the results in high resolution. Since you used “2” for the size of each point, the seven points on 
the line are displayed as small boxes. Try changing the size to “6” (the boxes are now much larger!). 
Change the size to the maximum: 9. 


Note: On the display that asks for the value of each point on the line, two prompts (MAXIMUM and 
MINIMUM) appear with a default value of zero. Enter nothing in these items for a simple Line Chart. 


If you enter values in these items, a vertical line will be drawn through the point from the maximum 
value to the minimum. Then a line is drawn back from the minimum value to the original point. The 
program does not check your values. MAXIMUM should be a number greater than the original point 
value and MINIMUM should be a lesser value. If both are left at zero, no separate line is drawn. 


These lines are always drawn with color zero and line pitch zero, but can be changed by modifying the 
generated features. 


Multi-Line Chart 


Now yow’re going to learn how to draw a multi-line chart. These charts are especially handy to use 
when you want to compare several sets of values on the same chart. 


Compare the quarterly sales of four paint companies: Company A, Company B, Company C, and 
Company D. Company A and Company C are the industry leaders and, traditionally, both have 
reported similar sales increases. Company B is a new company which has shown steady increases in 
sales. Company D is an old company that has been suffering nearly stagnant sales. 


36 


Because the second and third quarters (April through September) are the warmest months of the year, 
all companies reported their best sales during these quarters. Here are the companies’ sales figures: 


Quarter 


m GC Dd Re 


A 
12 
21 
18 
11 


Company 
B C 
6 15 
14 20 
13 21 
12 16 


wmohore wo 


From the data, you can see that you’ll have four lines (one for each company) and four “periods” 


(points) in each line. 


Enter these for the prompts: 


CHART TITLE: 
SIDE LABEL: 
BOTTOM LABEL: 
PERIODS: 
ITEMS/PERTIOD: 
NAME OF PERIOD 
fF NAME OF PERIOD 
NAME OF PERIOD 
NAME OF PERIOD 


DETAILS FOR LINE 


POINTS: 
COLOR: 
9 4 
LINE: 
COLOR: 
PITCH: 
VALUE FOR PERIOD 
LINE 
VALUE FOR PERIOD 
LINE 
VALUE FOR PERIOD 
LINE 
VALUE FOR PERIOD 
LINE 


QBAO1: 
OBOGES: 
2BO83: 
QBAGd: 


CAdOA1 


ZBOO1 


QOAO1: 


BAAS 


QOOO1: 


2BBO3 


QBOO1: 


ZAAO4 


QBOO1: 


You type: 


QUARTERLY COMPARISON 
PERCENTAGE INCREASE 
QUARTER 

{| 

4 

FIRST 

SECOND 

THIRD 

FOURTH 
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DETAILS FOR LINE 
POINTS: 
COLOR: 
= 8 Fs 
LINE: 
COLOR: 
PLIGHS 


VALUE FOR PERIOD 
LINE 


VALUE FOR PERIOD 
Link 


VALUE FOR PERIOD 
LINE 


VALUE FOR PERIOD 
LINE 


PETALLS POR -LIWe 
PUINTS + 
COLOR 
Slices 
LINE $ 
COLOR: 
PITCHS 


VALUE FOR PERIOD 
LINE 


VALUE FOR PERIOD 
LINE 


VALUE FOR PERIOD 
LINE 


VALUE FOR PERIOD 
LINE 


OOAB2 


BOBD1 


QBOO2: 


CQABZ 


QAAAZ : 


02003 


QBOG2: 


QAAddA 


QBOO2: 


2BAA3 


OOOO 1 


22003: 


2BAA=S 


2BOO3: 


28803 


2BO03: 


BOAAa4 


QBOO3: 


ZBSAG 


28014 


00813 


OOG1z2 


Q2BO1iS 


PABLO 


OBO2Z1 


2216 


You type: 


Oo 


DETAILS FOR LINE @@004 You type: 
POINTS: wr" 
COLOR: 2 
SIZE: 3 
LINE: 
COLOR: 3 
PITCH: 7 
VALUE FOR PERIOD @@0@@1 
LINE APBADA: A2BAAI1 
VALUE FOR PERIOD @@002 
LINE A2ABABA: 22ACS 
VALUE FOR PERIOD @8@803 
LINE 2BACAd: A2AABA 
VALUE FOR PERIOD @aaa4 
LINE QAAAA: 2PBAA? 


Now display the chart in high resolution on your Screen (the last line is in green, so you'll just be 
able to see the line’s points). This chart can be printed out on your dot-matrix Printer or on the Color 
Graphics Printer (the last line is not printed on black-and-white printers, but is printed on the Color 
Printer). 


Tips about the Line Chart prompts: 


NUMBER OF LINES You can have up to 255 lines in a chart but, if you go beyond six or eight, it is 
difficult to differentiate the lines and the chart will look extremely cluttered. 


POINT COLOR Points can be one of four colors (0-3). The specific color depends on the color set of 
the Screen or Printer. 


POINT SIZE The range for point size is 1 (smallest) to 9 (largest). If the size is zero, the points are 
not drawn. 


LINE COLOR Lines connecting the points can be one of four colors (0-3). The specific color depends 
on the color set of the Screen or Printer. Color 0 is best for the dot-matrix printers. 


LINE PITCH Pitch determines the “line style” for your line and ranges from 0-7. For example, 0 
is a solid line and 7 is a very finely dotted line. Line pitch does not apply to the display or the 
Black/White Printers. It only applies to the Color Graphics Printer. (Refer to the Color Graphics 
Printer Owner’s Manual for a discussion of the line pitch/style. Note: The Color Graphics Printer 
has a line pitch range of 0-15. Disk Graphics line styles are one-half of the printer line styles; i.e., 
Disk Graphics line style 1 is the same as the Printer’s style 2,2 is 4,3 is6...7 is 14.) 


VALUE FOR PERIODS Disk Graphics accepts values from 1 to 30,000 for each point. The line 
number (item number within the period) and the period number are shown at the top of the Screen 
for reference. 
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8/ Key Charts 


“Key Charts” are used to add a “key” or “legend” to a Vertical or Horizontal Bar Chart, a Line Chart 
or a Point Chart. (A Pie Chart already has section descriptions, so a key is not needed.) 


Since Key Charts are legends to a chart, they never stand alone. A Key Chart lets you use text alone 
or text with either a line, box, bar, or point in the key. Keys are especially useful to use on 
multi-group charts when you need to easily distinguish between the types of bars, lines, or points. 
After you’ve perfected your chart, save it on diskette and then start working on your key. (If you 
want to make any changes to a saved chart, you’ll need to load the chart definition before you can 
edit it.) 

KEY 


CJ RETAIL DIV. 


WE STEEL DIV. 
[=] PLASTICS DIV. 


Figure 20. Key Chart With Bars 


To use a Key Chart: 
1. You'll have to decide where on the Superscreen you want the Key Chart to go. 
2. Move the chart on the Superscreen to fit the Key Chart in. 


In the next figure, a chart on a high-resolution Screen is moved 60 Superscreen points up (vertically) 
and 60 points to the right (horizontally) on the Superscreen. 


‘“Superscreen’”’ 


Chart 
moved up & to 
the right 


Figure 21. Moving the Chart 
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For example, if there is a lot of extra space on the chart, the key can be superimposed on top of the 
chart. 


KEY 
C) Retail 
Steel 


GH Plastics 


AMOUNT 


JAN FEB MAR~ APR 
MONTH 


Figure 22. Key Superimposed on Chart 


If there’s not a lot of room, you can place the key anywhere on the Superscreen, according to your 
printing needs (you'll probably have to first move the chart on Graphics’ Superscreen). 


— 
= 
_ 
O 
= 
< 


Figure 23. Key Examples 


Size of Key Chart 


For aesthetics, you’ll usually want to make the Key as small as possible. To figure the minimum 
dimensions of a Key Chart: 


1. For height: Multiply the number of lines of text in the chart (plus 2 for the title) times 11. 
2. For width: Use the longest Key Chart description, add 4, and multiply times 6. 


Example: You have five items that you want in your Key Chart and the longest description has 10 
letters. 


1. 7 (number of lines plus 2 for the title) x 11 = 77 
2. 14 (longest key description plus 4) x 6 = 84 
So the chart will have to have a height of at least 77 and a width of at least 84. 


42 


PERIODS is the number of items you want to label and is the same as the number of bars, lines or 
groups of lines in your chart. The key in the preceding example has five “periods”. 


Retail Div. 


Periods & 


se os AREY ODN. Text Description 


. . Plastics Div. 


Figure 24. Periods on Key Chart 


Look at the main Data Prompts for a Key Chart: 


Ss , 


LINE 

TEAT/BAR/LINE/POINT (@-3) [@] 
COLOR CO] 
PITCH [@] 
ae eo Gas 
SHADING [CO] 
TEAT 

[ J 


LINE @@@@1 is the first item in a Key. 


TEXT/BAR/LINE/POINT (@-3) asks you what you want in front of the description (0, for text 
description only, is the default). 


Retail [__] Retail _____— ‘Retail @ Retail 


Steel Steel 


___. Steel ® Steel 


Piastics ©. Plastics 


Plastics Ga Plastics 


Text only (0) Bar (1) Line (2) Point (3) 
(differentiated 
by color and size) 


Figure 25. Key Types 
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COLOR is the color of the line, point, or bar in the Key. PI TCH determines the style of the line. SIZE / 
determines the size of a point and can be from 1-9. As the points become larger, they become boxes: 


e LJ S 


Size 1 Size 4 Size 9 


Figure 26. Example of Points 


TEXT is the description of the line as you want it to appear in the Key. There’s a description for each 
item in the Key. | 


Different types of charts use different Key Chart features: 


Feature Text Alone 


Table 4. Key Chart Features < 
Drawing a Key Chart oO 


To draw a Key Chart: 


1. Draw a chart and move it to a location on the Superscreen so that you can fit the key on the 
Superscreen. 


2. Figure the size of the Key Chart you need and create a Key Chart. For the chart title, use KEY or 
LEGEND. This title is centered at the top of the Key Chart. 


Sample Session 


For an example of a Key Chart, first do a Horizontal Bar Chart plotting the monthly profits over a 
three-month period for the three divisions that compose Acme Inc:.: 


Retail Div. Steel Div. Plastics Div. 
JAN 11 9 fi 
FEB 15 13 18 
MAR 4 2 8 


Be sure the chart’s dimensions are 191 for the height and 255 for the width and the chart’s lower-left 
corner is at 0,0. If you need help, see Chapter 6. (You don’t have to worry about Color or Shading — 
this is done automatically by Disk Graphics.) 


Now add a Key Chart: 


1. Display the Main Menu and press: (2) (2) C1. i. 
2. Fromthe TYPE OF CHART menu, press: (5). 
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3. A group of prompts appears on the screen. Answer these prompts as follows: 


@ Forthe CHART TITLE prompt, type: KEY. 
@ For the CHART HEIGHT prompt, type: 95. 
@ For the CHART WIDTH prompt, type: 128. 
@ Forthe CHART UP POSITION prompt, type: i932. 


@ Forthe CHART RIGHT POSITION prompt, type: 75 (ENTER). (This centers the Key Chart on 
top of the Bar Chart.) 


. On the next screen of prompts: 


@e Press (3) for PERIODS. 


. The TEXT/BAR/LINE/POINT (@-3) prompts are now displayed. A new set of these prompts 


will be provided for each line in the Key Chart. Respond as indicated below: 


e For the first-line prompts, press: (1). (This gives you a bar in front of the description in the Key.) 
Move the Cursor to TEXT andtype: RETAIL DIY. (ENTER). 


e For the second-line prompts, press: (1). Move the Cursor to SHADING and press: (1). Move the 
Cursor to TEXT andtype: STEEL DIV. (ENTER). 


e For the third-line prompts, press: (1). Move the Cursor to COLOR and press: (1). Move the 
Cursor to TEXT andtype: PLASTICS DIY. (ENTER). 


. Display the charts in high resolution. Since the Key is over the chart, you'll have to use Image Size 


Reduction: 1 to see the Key Chart. Try printing the chart on your dot-matrix printer or Color 
Graphics Printer. (For the dot-matrix printer, type: 315 forthe MAXIMUM ‘Y’ USED prompt.) 


Note: Before printing it on a dot-matrix printer, you must display your chart without scale 
reduction. If you don’t, it will be reduced on the dot-matrix printer and may be unreadable. 
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9/ Point Charts 


Point Charts, or scatter diagrams, are used to show the relationships between specific items. They 
generally require that a large amount of information be entered and are likely candidates for being 
produced with the aid of a BASIC program. 


Point Charts are often used to “look for” a subtle relationship between items. For example, a chart 
might be produced that places a point on the chart for each person in a department. The vertical 
position could indicate the person’s salary, while the horizontal position could indicate the months of 
service with the company. If enough points are plotted, one might expect the points to gather around 
an imaginary line that runs upward from left to right. In other words, the longer the service, the 
higher the salary. 


Defining a Point Chart starts the same as Line and Bar Charts. After entering the title, size, and 
position, you supply the side and bottom labels. (For example, the side label could be SALARY and the 
bottom label could be MONTHS OF SERVICE. Then the number of points to be plotted is entered. If 
you have 255 points or less, enter the number in either the PERIODS prompt or the ITEMS PER 
PERIOD prompt (leave the other with a value of 1). If you have more than 255 points, use the two in 
combination. The product (result of multiplying together) of the two is the number of points to plot. 750 
points, for example, can be plotted by entering 75 in PERIODS and 10in ITEMS PER PERIOD. 


The next set of prompts looks like this: 


VALUES FOR POINT #80001 


HORIZONTAL [88001] 
VERTICAL COOe0e01] 


Puce @i2e 21.) 
COLOR CO] 


Continuing with the previous example, point 1 is information about the first person to be plotted. The 
horizontal value is the months of service. The vertical value is the salary. (Point size and color will be 
discussed later.) After entering the information for this person, press and repeat the process for 
all other people being plotted. After the last one has been entered, you will be returned to the Main 
Menu. You can then display the results. 
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The results are different from bars and lines in that there are two scales printed — one vertical and one w/ 
horizontal (like a piece of graph paper). 


SAMPLE 


SECOND NUMBER 


Figure 27. Point Chart 
Additional information can be shown on a Point Chart by using the point size and/or color to show a Y 
third or even fourth variable. For example, male employees could be shown with blue points and 
females with red points (best done on the Color Graphics Printer). In addition, age could be shown by © 
using point size, with size 1 representing employees under 25, size 2 for those 26-30, size 3 for those 
31-35, etc. As a result, a chart can be drawn that gives an instant “feel” for the type of people in the 
department. 


Zo OOO 
888d 
15800 


18000 


2 OO@ 


48 Figure 28. Point Chart with Point Size Variable 


Hints About Point Charts 


The generated features require less space if you presort your information so that you enter all items 
with the same point size and color together. As long as these items are the same, only a “point” feature 
(5 bytes) is generated. Each time you change to a new color or size, a “set defaults” feature (5 bytes) is 
generated, and then the “point” feature is also generated (for a total of 10 bytes). 


You can control the upper limit of the scales by entering a single point containing a value you want 
represented at the upper-right corner (all other points should be less than this value). Use size zero for 
this point. It will not be shown but will affect the scale. 


49 


@ ® ® a 
10/ Displaying/Printing 

You can display/print charts in all of the following ways: 

@ Four-color low-resolution Screen (96 x 128) with three-color shading. 

e Two-color high-resolution Screen (192 x 256) with three-color shading. 

@ Dot-matrix printer with graphics capabilities. Three types of shading are possible. 


@ Color Graphics Printer. 


Image Size Reductions 


Image Size Reductions was discussed briefly in Chapter 3. Reducing the “Screen image” (by reducing 
the size of the Superscreen) is especially useful when building charts for the Printer that are larger 
than the dimensions of a high-resolution Screen (191, height; 255, width). 


When you reduce the image, you can see a “scaled down” version of the chart, exactly as it’ll be printed 
on your Printer. 


Image Size Reduction has a range of 0 (full sized) to 3 (1/8 of the original Screen size). There is a loss of 
resolution when images are reduced. For example, when an image is reduced to one-half its original 
size, only every second point of every second line is displayed. Likewise, with one-fourth or one-eighth 
reductions, every fourth or eighth point of every fourth or eighth line, respectively, is displayed. 


full-sized 


1/2 of original 
1/4 of original 
1/8 of original 


Table 5. Reduction Chart 


1/2 Reduction: 6 


A ; Reduction: 1 
Reduction: 2 


Reduction: 3 Figure 29. Reduction Sizes 
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Example: When you enter (1) for the reduction size, Graphics shrinks the Superscreen to 1/2 its ae 
width and 1/2 its height (total reduction: 1/4 of original). You have much less detail with reductions 

but, in this case, you get to see four times as much of the Superscreen on the high-resolution 

Computer Screen. 


Note that when you reduce a chart’s image, you do not change the chart’s dimensions; you are simply 
“making a reduction” of the Superscreen, just like you can do on some photocopiers. 


For example, if you are building a large chart for a printer, you can only see parts of it on the 
| high-resolution Screen. By reducing the image, you can get a look at the chart’s “total picture” and 
| make sure it’s correct before you print. 


Sample Session 


Go through a practice session where you draw a Pie Chart and display the chart in all four ways. 
Title the chart: ABC SHOE CO. FEB. SALES. 


These are the February sales figures: 


casual $2,738 
athletic $2,159 
boots $2,066 
dress shoes Si S32 
house shoes $1,285 


Enter the figures and section titles. The section descriptions are: casual, athletic, boots, dress shoes, | : 
and house shoes. For each section’s “size”, enter the respective sales figure for that month (don’t enter Nad 
| the comma or the dollar sign). 


Boots are a new line for the ABC Shoe Company and did quite well during the winter month of 
February. To highlight this, color the boot section with Color 1 and enter C1) for Shading Exception 
(this will shade this section). Also offset the section by 15 points. When all the information is entered, 
you'll be returned to the Main Menu. To display each type of chart, press: (6) from this menu. 


Low-Resolution Screen 
A low-resolution Screen has 96 pixels on the Y-axis and 128 pixels on the X-axis. From the Display 


Method Menu, press: (1). Before displaying a chart on a low-resolution Screen, the chart definition 
should specify a height of 95 and a width of 127. 


EE ES A a I — 


When you display charts in low or high resolution, this series of prompts is listed on your Screen: 


) DISPLAY WINDOW LOCATION 
| (LOWER LEFT CORNER) 


IMAGE SIZE REDUCTIONS 


Press: (1) (ENTER), and the chart is displayed. The “boot section” is shaded in blue. 


| 52 


“A 


The X and Y values indicate what part of the Superscreen is to be displayed on the Screen (the 
lower-left corner is 0,0). If you do not enter any values for X and Y, Disk Graphics draws as much of 
the chart (starting in the lower-left corner) as possible. 


You only need to enter values here if you want to move the window through which you view the 
chart. Move the window slightly by entering 20 for X and 20 for Y. Display the chart in low 
resolution. All of the chart is visible except for the lower-left corner of the Superscreen. 


CHART POSITION (part of the chart definition) determines where on the Superscreen the chart is 
placed. DISPLAY WINDOW LOCATION determines what part of the Superscreen is displayed. 
High-Resolution Screen 


In high resolution, there are 192 pixels on the X-axis and 256 pixels on the Y-axis. To draw the chart 
in high resolution, from the Display Method Menu, press: (2). From the prompts, press: (ENTER and the 
chart is drawn. In high resolution, the “boot section” is shaded in light gray. 


Change the Image Size Reduction to 3. The chart has been shrunk to 1/8 its original size. 


Color Graphics Printer 


With the TRS-80 Color Graphics Printer, Model CGP-115 (26-1192), a chart can have a width of 0 to 
999 and a height of 0 to 950. 


The Color Graphics Printer lets you print: 
e Extra-tall charts (up to a maximum of 950). 
e Extra-wide charts (to the 999 maximum). 


e A combination of both extra-wide and extra-tall charts over two sheets of paper (which you'll attach 
with cellophane tape). 


(0,950) (999,950) 


Two-Sheet Maximum 
(999, width; 
950, height) 


(0,480) (999,480) 


One-Sheet Maximum 
(999, width; 
480, height) 


Paper feeds in this direction 
from the printer 


(0,0) (999,0) 


Figure 30. Extra-Wide, Extra-Tall Printing 


It is important to remember that the Color Graphics Printer turns all charts and labels 90 degrees from 
the way they appear on the Color Computer Screen. 
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From the Display Method Menu, you can see there are two choices for a Color Graphics Printer: 
es. 480 x 999 4 COLOR PRINTER 
® 6. _ COLOR PRINTER <AURPER: 1/2) 


Unless you’re going to make your chart taller than 480, it will fit on one sheet of paper and you'll select 
Display Method Menu Selection: (5). 


If it’s taller than 480, you'll first select Display Method Menu Selection: ($5) (which prints the “bottom 

half of the chart”), and then you’ll select Display Method Menu Selection: (6) (which prints the “upper 
half” of the chart). You’ll then have to tape the two sheets of paper together to have a completed chart. 
The two halves will overlap by 10 Superscreen points to aid in aligning the two halves. 


Special Notes about Printing: 


@ On extra-wide charts, the paper on the Color Graphics Printer has a tendency to “wrap into” the 
Printer during printing, causing distortion. Be sure to have the Paper Separator correctly in place to 
prevent this wrapping. 


e Asa sensitive plotting instrument, the Color Graphics Printer works best with smaller charts. As a 
rule, the wider and taller a chart is, the greater the chance for some distortion. 


Procedure for Printing: 


1. First you have to decide what you want the dimensions of your chart to be. If a chart is especially 
tall (over 475 points), you’ll have to print it out over two sheets of paper. 


2. Then you'll have to change the chart’s dimensions to fit your needs by Creating or Editing the chart. 
From the Main Menu, press: (2) (CREATE A CHART), then: CD (to Edit) or (2) (to Create). Then 
you may set or change the chart’s default size: 


OVERALL CHART SIZE: 


HEIGHT Caeigid 
WIDTH [C@O@255] 


Wide Chart 


Print your Pie Chart out on the Color Graphics Printer as wide as it will go. First, you’ll have to edit 
the chart’s dimensions. From the Main Menu, press: (2) (CREATE A CHART), then: CLD. Move the 
Cursor up and change the chart’s height to 470 and the width to 999. Enter these dimensions in the 
size prompts: 


OVERALL CHART SIZE: 


HETGHT [Ood70] 
WIDTH cge9g99] 


These dimensions take advantage of the wide height and width capabilities of the Color Graphics 
Printer. 
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To print: 


1. Be sure the Printer is connected and turned ON. 

2. From the Main Menu, press: (6). 

3. From the Display Method Menu, press: (5). The chart’s Features are flashed on the Screen as they 
are “translated” and sent to the Color Graphics Printer. When printing is completed, the Main 
Menu returns to the Screen. 


Medium Square Chart 
Change the chart’s height to 400 and the width to 400. This prints a chart that is square. 
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Figure 31. Square Chart 


Extra-Wide and Extra-Tall Charts 


To print this chart at the maximum size, change the chart’s height to 950 and its width to 999. Then 
print once using Display Method Menu Selection: (5) (which prints the “bottom half” of the chart), and 
again with Display Method Menu Selection: (6) (which prints the “upper half” of the chart). Then tape 
the two halves together. 


Dot-Matrix Printers 


You may use dot-matrix printers with graphics capabilities to print your Disk Graphics displays. The 
printers can print heights to 999 and can use the entire Superscreen for extra-wide printing over two 
sheets of paper. 


Menu Selection (3) (999 x 48@ B/W PRINTER) lets you print the left half of a display that is up 
to 999 in height and 480 in width. Menu Selection (4) (B/W PRINTER (RIGHT HALF)) lets you 
print the right half of a display that is up to 950 wide on the second sheet of paper. After they are 
printed, you can tape the two sheets together. 
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(0,999) (480,999) (950,999) 


One-sheet maximum Two-sheet maximum 
with dot-matrix printers 
with graphics capabilities. 


(0,0) (0,480) (950,0) 
Figure 32. Two-Sheet Extra-Wide/Extra-Tall Chart 


When you draw (or edit) the chart, you’ll have to decide how tall and wide you want the chart to be. 
Then you'll have to be sure you tell the Printer these dimensions. 


For example, if you want to print a chart that’s 800 x 650, you can get these dimensions by entering 
the values for the chart’s size (in the first chart prompt): 


OVERALL CHART SIZE: 
HEIGHT C2PBA0] 
WIDTH [28650] 


To print with a dot-matrix printer: 


1. Draw (or load from diskette or cassette) the chart. 

2. From the DISPLAY METHOD? prompt, press: (3). 

3. The next prompt (MAXIMUM ‘Y¥’ USED) lets you decide how much of the Superscreen to print. If 
the chart fills the high-resolution display, use 195. If you have specified different chart sizes when 
you built the chart, you will have to tell the Printer these dimensions. 


As soon as you tell the Printer the height of the chart, the Screen changes to the green graphic 
Screen and fills with graphics-looking lines and dots. The chart is then printed in sections. Each 
section is loaded into the program’s buffer and printed. As a section is sent to the Printer, the dots 
disappear. Then the procedure is repeated. 


Each time it goes through the process, 14 print lines (98 Superscreen lines) are processed. When 
printing is finished, the Main Menu appears. If you need to stop printing anywhere along the way, just 
press (BREAK) and you'll get back to the Main Menu. 
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Wide Charts 


The maximum “one-sheet” printing width with a dot-matrix printer is 480. If you have created a very 
wide chart (over 475 points wide), use Display Method Selection: (4) (B/W PRINTING (RIGHT HALF )) 
to print the right half of the Superscreen. 


When you do this, there’s a slight overlap (10 Superscreen Points) which helps you “line up” the two 
halves of paper when you tape them together. This lets you have a maximum printing width of 950 
points (480 + 480 — 10), which is nearly two full sheets of paper! 


Plot a Line Chart and print it on a dot-matrix printer. This chart will plot the population of “Anytown, 
USA” from 1940 to 1980. Here are the figures: 


1940 2,236 
1945 3,115 
1950 5,248 
1955 6,077 
1960 fae 
1965 8,644 
1970 11,606 
1975 13,540 
1980 11,498 


Title the chart ANYTOWN POPULATION. Fromthe OVERALL CHART SIZE prompt, for height, 
type: 72, and for width, type: 45@. For the side label, type: NO. OF RESIDENTS. For the bottom 
label, type: YEAR. For periods, type: 9. 


Name the first period: 48. Name the second period: 45, etc., until all periods have been labeled. On 


or’ 


the next prompts, for the Line Color, type: 2. 


Type in the values for each period and you’re back at the Main Menu. Your chart is ready to display. 
Take a look at it in high resolution before you print. Only the lower-left corner of the chart is visible. 
Always display the chart with no scale reduction before printing or it will be printed in the reduced 
S1Ze. 


To print: 


1. Be sure the Printer is set for 8-bit serial to print graphics (see your Printer’s owner’s manual). 

2. From the DISPLAY METHOD? prompts, press: (3). 

3. The next prompt (MAXIMUM ‘YY’ USED) lets you decide how much of the Superscreen you want to 
print. Since you set the chart on the Superscreen as being 700 tall, you’ll need a slightly larger 
value here. Type: 720 and printing begins. 


Note: To print a chart further right on the paper, change the chart position on the first screen of 
your chart definition. 


When Using a 32K Color Computer. .. 


When you use a 32K Color Computer, printing takes advantage of the extra memory available in a 
32K Computer. Since the Disk Graphics program can generate output for the Printer faster than it 
can be printed, the extra memory is used to store output until the Printer catches up. 


As a result, it is possible to get over ten minutes ahead of the Printer. Instead of doing nothing while 
the Printer is running, Disk Graphics allows you to go on with your work. 


After “printing”, the program will display how much data remains in memory to be sent to the 
Printer. You will see the numbers counting down as information is sent to the Printer. When the 
display reaches zero, the Main Menu will appear automatically. If you want to cancel the remaining 
printing, press (2). The Printer will stop and the Main Menu will appear. 


5/7 


If, however, you want to go on with your work of creating, saving, loading, displaying, and printing 
charts, press (1). The Main Menu will appear and you can continue working while the Printer 
continues to print. Each time you return to the Main Menu, you will first see how the Printer is 
doing and have an opportunity to cancel the rest of the printing. If you are looking at the Main Menu 
and decide you want to check up on the printing, press (1_) (BREAK). 


Important Notes: 


® Before every line, Disk Graphics sends a command to the Printer that shifts it into Graphics Mode. 
If you want to use the Printer for normal printing, turn it OFF and then back ON. 

e Since dot-matrix printers have outstanding resolution (480 addressable dots horizontally on one 
sheet of paper), they take a little longer to print a graphics display. 

@ Onthe MAXIMUM *‘¥’ USED prompt (which is asking for how much of the Superscreen’s height is 
to be printed), always add 10 to the maximum height of your chart. For example, if you have a chart 
that’s 600 x 400, use 610 for the height so you'll be sure to get the entire chart printed. 
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11/ Chart Features 


From your chart definition, Disk Graphics generates a set of “Features” that defines the points, lines, 
text strings, etc., from which your chart is actually printed or displayed. 


By editing the Features, you can “customize” a chart to fit your special needs. Save a copy of the 
changes you make to the Features on a disk work file. 


For example, if the bottom label doesn’t look right, you can change its size, color, or location by 
modifying the generated Features. 


Creating your own Features is especially handy when you want to add a company logo, business seal, 
trademark, slogan, etc., to your chart. As you become more familiar with Features, you'll see you can 
create just about any kind of image you want by combining points, lines, rectangles, arcs, circles, etc. 


Superimposed 


Logo 

foo: 

= 

_ 

2) 

= 

< 

JAN FEB MAR APR 
MONTH 
Figure 31. Company Logo and Bar Chart 

Editing Keys 
There are four keys you can use when you are editing Features: 
SHIFT)CY ) the next Feature is displayed on the Screen. 
SHIFDCF) the previous Feature is displayed on the Screen. 
scrolls forward to the next “remark” Feature or to the end of Features, 


whichever comes first. 
You can use Features three ways: 


@ To add new features that are superimposed on a chart (such as a company logo). 
@ To display or print the Features independently of a chart’s definition. 
@ To change the generated Features for a “customized” look. 
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Once you choose the Clear Features selection, Disk Graphics does a double-check to make sure it’s we 
okay to clear memory. (It clears Features, not chart definition. ): 


ABOUT TO CLEAR FEATURES! 


i. CANCEL REQUEST TO CLEAR 

2+ OK TO CLEAR 

PRESS CHOICE NUMBER 

(BREAK OR ENTER FOR MAIN MENU) 


Disk Graphics keeps track of where the first Feature generated from your definition is stored. When 
you “Revise a Chart”, the revised Features are stored in the same place on disk, replacing the 
previous Features that were stored there. 


However, if you use Edit Features (Menu Selection: (5)) and change a Feature, Disk Graphics is no 
longer sure where the first Feature is located. So, Disk Graphics assumes you have “customized” a 
chart, and all subsequent Features generated from your definition are added to the end of the list of 
Features. To avoid this, use Clear Features before revising a chart. Otherwise, your revised chart will 
be “superimposed” over the original. 


To edit the Features, from the Main Menu, press: (5) (EDIT FEATURES). The first Feature is 
displayed. If there are no Features stored, the following will be displayed: 


END OF FEATURES OR COMMENTS [@] 


TYPES: 
@=END OF FEATURES (DELETE) 
1=COMMENTS (INSERT) 
2=SET DEFAULTS 
S=RECTANGLE 
4=TEAT 
S=POINT 
G=LINE (CONTINUATION) 
7=LINE (SEPARATE) 
B=DEFINE CIRCLE 
9=DRAW AN ARC 


These 10 items (0 through 9) on the Screen are the types of Features: 
@ @=END OF FEATURES (DELETE) Indicates that no additional Features follow. 


@ 1=COMMENTS (INSERT) This Feature is used only for reference. A comment Feature is 
generated at the beginning of every chart. 


e 2=SET DEFAULTS Set Defaults is used to specify the size, color, and pitch of all subsequent points : 
and lines. To get these prompts, press: (2). 
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SET DEFAULTS C2] 


POINTS: 
COLOR CO] 
1. [CO] 
LINES: 
COLOR [CO] 
PITCH CO] 


| DRAW A BOX xe 
| LOWER-LEFT COORDINATES 
| x COdAaO] 
¥ CASO0O] 
| COLOR [a] 
PITCH CO] 
HEIGHT C2SA8S I 
rp 6 (N | WIDTH CO28OO] 
| SHADING C2] 
@ 4=TEXT Text String is used to print text in any size, color, or direction. To get these prompts, 
press: (4). 
| 
| TEXT STRING [4] 
START COORDINATES 
x CAAPAO] 
¥ COO00O 
: COLOR [01 
| SIZE [1] 
DIRECTION CO] 
| TEXT 
! [ ] 
@ 5=POINT Point works with the “Set Defaults” feature by drawing a small square at the coordinates 
specified. Size and color are set with the “Set Default” feature. To get these prompts, press: (5). 
DRAW A POINT 
COORDINATES 
vi CPPAA0] 
Y C2OdOaO] 
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@ G=LINE (CONTINUATION) Line Continuation draws a line from the last location used to the 
location specified. The line’s color and pitch are set with the “Set Defaults” Feature. To get these 


prompts, press: (6). 


DRAW LINE FROM LAST POINT 


DESTINATION COORDINATES 
A C2A20O] 


¥ [2AO8O] 


@ 7=LINE (SEPARATE) Line Separate draws a line from one specified location to another (with you 
supplying the start and end coordinates). No points are drawn. To get these prompts, press: (7). 


DRAW SEPARATE LINE Ce 
START COORDINATES 
x [22000] 
Y C2000) 
END COORDINATES 
x C2A000] 
7 CAAd8O] 
COLOR CO] 
PITCH [O] 


@ 8=DEFINE CIRCLE Circle is used to specify the center location, radius, and starting angle of a 
circle. To get these prompts, press: (8). 


DEFINE A CIRCLE 


CENTER LOC: 


A [82000] 
¥ [COOO0O] 
RADIUS [COdaae ] 
STARTING ANGLE C28dO0] 


@ 9=DRAW AN ARC Arc draws apie section, starting at the last angle used and continuing 
counterclockwise for the number of degrees specified. The arc can be offset from the center of the 
defined circle, if you wish. To get these prompts, press: (9). 


DRAW AN ARC C9] 
DEGREES [COdOOO] 
COLOR CO] 
OPP Set [CO2000] 
SHADING [@] 
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Feature Exceptions 


Note that changes in the Features on the Screen do not affect what is stored on disk unless (ENTER) is 
pressed, with these two exceptions: 


e Feature type to 1 If you change the Feature type to 1, a remark Feature is stored on disk ahead of 
the current Feature. You can then change this stored Feature to any other type. 


END OF FEATURES OR COMMENTS Cid 


e Feature type to 0 If you change the type to 0, the current Feature is deleted from disk and the next 
Feature is displayed. 


Any other change to the Feature type changes the format of the Screen but does not affect what is 
stored on disk. Pressing (ENTER) causes the current Feature to be replaced by the one on the Screen. 


Text Direction 


Text can be displayed/printed in one of four directions: 


0 = bottom to top 


TEXT 


1 = left to right (standard printing direction) 
aang 
TEXT 
2 = top to bottom T 
E 
X 
T 


3 = upside down from right to left 


ixsal 
Rs ae 


Practice Session 
Now use Edit Features to create your own drawing: 


1. Clear Features. Type: C1) (2). 

2. From the Main Menu, press: (5) (4). 

3. From the Text String Prompts, enter 18@ forthe START COORDINATE: X and 14@ for 
the START COORDINATE: Y. 

. For COLOR, press: CD); for SIZE: (2); and for DIRECTION: (3). 

. For TEXT, enter (in uppercase letters): GRAPHIC (ENTER). 
Now press: (3). 

6. For the Box Prompts, enter 9@ for the LOWER-LEFT COORDINATE: X and 5@ for 
the LOWER-LEFT COORDINATE: Y. 

7. For COLOR, type: 2; for HEIGHT: 50; for WIDTH: 80; andfor SHADING: 1 (ENTER). Now 
press: (7). 


oa 
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8. From the Separate Line Menu, enter: 2@ forthe START COORDINATE: X and 16 for 
the START COORDINATE: Y. Forthe END COORDINATE: Xk, enter: 248. For 
the END COORDINATE: Y, enter: 18@. Press (ENTER) (BREAK) and you're back at the Main Menu. 


Now display the results on the Screen. You'll have a box, a diagonal line, and the word GRAPHIC 
displayed on the Screen. GRAPHIC is displayed with Text Direction 3 (upside down from right to left). 


Creating a Logo 


Create a logo under a Line Chart. First clear memory, and then plot a new chart of the apartment unit 
starts for Western Builders Inc. over a 10-month period (due to a shortage of space, type only the first 
letter in the name of each month): 603, J(une); 772, J(uly); 505, A(ugust); 503, S(eptember); 383, 
O(ctober); 396, N(ovember); 513, D(ecember); 299, J(anuary); 323, F(ebruary); and 546, M(arch). 


Make the chart size 191 (height) and 255 (width). Position the chart on the Superscreen at 60 (up) and 
130 (right). After the chart is entered, press to get back to the Main Menu. 


Western Builders Inc. is a subsidiary of ACME STEEL and uses the sales slogan: “We're building this 
one for you!” This is how their logo looks. 


“We're building this one for you!” 


WESTERN BUILDERS. JING, 


a subsidiary of ACME STEEL 
Figure 32. Logo 


You can see that this logo uses a rectangle with the firm’s name and two lines of text. To create this 
logo: 


1. From the Main Menu, press: (5). Press @). This will advance you to the end of the Features that 
were generated for your chart. 

2. Press (3) (this selects the box/rectangle option). For the lower-left coordinates, enter 13¢@ for X and 
25 for Y. For the height, type: 19. For the width, type: 261. (This means the rectangle will have a 
height of 19 Superscreen Points and a width of 261.) Press (ENTER). 

3. Press: (4). Now enter the name of the company inside the rectangle by giving the proper 
coordinates. For the Starting Coordinates, type: 133 for X and 27 for Y. For Color, press: CD; 
Size, (1); and Direction, (1). For Text, type: WESTERN BUILDERS INC. (ENTER). 

4. Press: (4). Now enter the slogan. For the Sirsa Slat type: 155 for X and 48 for Y. For 


Direction, press: (1); for Text, type: "WE UILOL |" (ENTER). 
5. Press: (4). Now enter the "SUBSIDIAR\ re For ie ‘Starting Coordinates, ,type: 18@ for X 
and i5 for Y. For Direction, press: (1). For Text, type: A SUBS Pm ACME STEEL 


(ENTER) (BREAK). 


Display the chart on your high-resolution Screen (set the Image Size Reduction to 1 so you can see the 
entire chart). If you have a printer, go ahead and print the chart (after displaying it with no reduction). 


If you want an example of a more sophisticated logo, see Appendix C, Features Logo. 


About Getting Logos Just Right... 


As you can see from drawing this logo, to get the exact coordinates and spacing in a logo (especially if 
the text is centered in the logo as it is in the previous example), you'll have to experiment and use some 
“trial and error” before you'll get the coordinates just right. 


You'll also probably want to change the size of the logo when you display or print it. Be sure to save 
each set of Features on a disk work file so you’ll have a permanent copy that you can re-use or edit. 
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Tips On Drawing Feature Displays: 


1. Draw out the dimensions of your chart on a piece of paper. 

2. Figure the coordinates of each part of your Feature display/logo by roughly “plotting” the display on 
the paper. 

. Enter the coordinates. 

If the display is still not like you want it, edit the Features. 

Character size is 6 points wide by 10 high for size 0, 12 x 20 for size 1, 18 x 30 for size 2, etc. 


Or oo 


Memory and Chart’s Features 


You should clear the memory of the previous chart’s features before starting to create a new chart so 
you'll eliminate the traces of any previous chart that you have created. 


From the Main Menu (Menu Selection: 1), you can clear the chart’s features. To do this, press: 


1. From the Main Menu: (1). 
2. From the Double-Check Prompt: (2), and you'll be returned to the Main Menu. If you decide you no 
longer want to clear features, press: (1), (BREAK), or (ENTER) and you'll be returned to the Main Menu. 


Note: This does not affect the stored chart definition. 


Editing Features 


As mentioned earlier, features are stored on a disk work file. Whenever you insert, delete, or change 

the size of a feature, all of the remaining features must be shifted up or down in the disk file to make 
room. If you have more than 256 bytes of features, this will result in disk I/O activity. In spite of this, 
the delay is usually minimal. 


The disadvantage of using disk is offset by the fact that you can work up to 64K bytes of features at one 
time (disk capacity permitting). Since a few hundred to perhaps a thousand bytes is typical, you should 
never run out of room. 
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12/ Saving and Loading (Diskette and 
Cassette) 


There are two types of files you can save on diskette or cassette: 


@e Chart Definitions 
e Chart Features 


Both have slightly different procedures for loading and saving. 


Saving and Loading a Chart Definition File 


To save or load a chart definition file on disk: 


1. Display the Main Menu and press: (4) for the SAVE prompts or (3) for LOAD. These 
SAVE/LOAD prompts will appear on your Screen. 


\. — 


SAYE/LOAD FILE NAME (CCHARTDEF I 


WHICH DATA? Lig 
[C@=FEATURES, 1=DEFINITION] 


DEVICE [@] 
C@=DISK, 1=TAPEI 


DISK DRIVE CO] 

MEMORY CONTAINS: 

KAAAA FEATURES 

x DEFINITION | 
AAAKA FREE GRANULES (DRIVE @) | 


o o o o 


SAVYE/LOAD FILE NAME Disk Graphics has a default filename (CHARTDEF) already entered, 
if you want to use it. If not, enter your own filename. 


WHICH DATA? When saving/loading a Chart Definition, this variable must be “1” (the default). 


DEVICE — Since you will normally be saving and loading on disk, Disk Graphics contains a 
default of zero (disk). You only need to change it to 1 if you want to save or load on cassette tape. 


DISK DRIVE — There is a default of zero, since it is more convenient to keep most of your charts on | 
the same diskette as the program. This can be changed if you want to save or load from another | 
Disk Drive. 


MEMORY CONTAINS The Save/Load Prompts show you how much Features and Chart Definition 
data is currently in memory (in bytes). You can also see how much free space (in grans) is on 
Drive 0. 


2. After answering the Save/Load Prompts, press (ENTER). 


If you just saved a Chart Definition file, you’ll be returned to the Main Menu. If you just loaded a 
Chart Definition file, the program will automatically go through the chart definition procedure to 
generate features before returning to the Main Menu. 
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Saving and Loading a Features File 


Saving and loading a Features file is just like saving/loading a Chart Definitions file, except you change 
the WHICH DATA? prompt to 0 (for “Features”): 


WHICH DATA? CO] 
(@=FEATURES»s 1=DEFINITION) 


Also, after a features file has been saved or loaded, you'll be returned to the Main Menu. 


Disk Graphics adds a file name extension of /DEF to all Chart Definition files and /FEA to all 
Features files. This makes the difference more obvious on a display of the disk directory (see the 
Color Computer Disk System Manual) and helps insure that a Chart Definition file is not loaded as if 
it were a Features file. 


You should be aware of the fact that Chart Definitions and Features require twice as much disk 
space in your files as they do in the work files. This is important only if you are working with very 
big files. 


Important Note: If the system “hangs up” for any reason, press the RESET button on the back of 
the Color Computer. When the message, “FILE NOT CLOSED AFTER CHANGES,” appears on the 
Screen, press to return to the Disk Graphics program. 


Be sure to name each file with a different name. To keep the Features and Chart Definitions files and 
cassettes organized, you might want to keep a log. 
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Appendix A/ Graphic Error Messages 


When you get an error message, Disk Graphics clears your entire Screen, the error number is displayed 
(for looking up suggested actions in this appendix), and a one- or two-line description of the error is 
shown. For example, error #1 says, “NOT TALL ENOUGH FOR DESCRIPTIONS”. This should 
minimize the time spent looking up errors in the manual. 


Note: Most errors encountered while defining a chart must be corrected before you can return to the 
Main Menu. 


Check this table for solutions: 


Number Description 


2 NOT WIDE ENOUGH FOR TITLE. ; 
Title too big. A minimum of 6 points of width is required for each letter and 
space. Options: Make the chart wider or use a shorter title. 


a NOT TALL ENOUGH FOR SIDE LABEL. 


Chart not tall enough for left label. Options: Make the chart taller or use a 
shorter label. 


6 NOT WIDE ENOUGH FOR BOTTOM LABEL. 
Chart not wide enough for bottom label. Options: Make the chart wider or use 
a shorter label. 


8 NOT WIDE ENOUGH FOR PERIOD LABELS. 
Period titles too long. Options: Shorten your longest bar label, use fewer 
periods, or make the chart wider. 
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Description 


ALL BAR HEIGHTS ARE ZERO. 
aximum height is zero. Disk Graphics “suggested” a value of 1 for each 
ar, but you changed them to zero. Solution: Supply at least one value 
reater than zero. 


NOT BIG ENOUGH FOR PIE. 
Not enough room for Pie Chart’s circle. A circle must have a radius of at least 
5. Options: Make the chart larger or make the largest offset value smaller. 


NOT TALL ENOUGH FOR DESCRIPTIONS. 
Horizontal Bar Chart not tall enough for period descriptions. Options: Make the 
chart taller or use fewer periods. 


NOT TALL ENOUGH FOR ALL KEY LINES. 
Key Chart not tall enough for all lines in key. Options: Make the Key Chart 
taller, eliminate the Bottom Label, or describe fewer items in your chart. 


MAX HORIZONTAL POINT VALUE IS ZERO. 

aximum horizontal point position is zero. A value of 1 was suggested for all 
points but you changed them all to zero. Solution: Supply at least one value 
greater than zero. 


Description 


CAN’T EXPAND FEATURE FILE. 

No room to expand Feature Work File. Last chart’s Features were deleted. 
You ran out of free space on Drive 0. Options: Exit the program and clean up 
your files. KILL those that you no longer need or COPY some to another disk 
and then KILL them. You might be able to pick up some free space by KILLin 
DEFWORK1/WRK, DEFWORK2/WRK, and FEAWORK/WRK if they have 
more than 1 gran assigned to each. 


ee ee ee ee ———— ~ tei -_ 


Appendix B/ Graphic 
Terminology/Range Summary 


Definition 


offset 0-250 Determines how many “graphic points” a pie section 
is “offset” from the pie. 


percent 0-1 Determines if pie section descriptions have 
percentages shown. 


point color OS | Determines the color of a point on a Line Chart. 


reference 0-1 Determines whether letters or lines are used to 
reference pie sections. 


value of period 1-30,000 Determines the height of a line or the size of a bar. 
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Appendix C/ Features Logo 


You'll probably want to create some very sophisticated logos, seals, etc., and use these displays over 
and over again on your charts. Here’s an example of a logo: 


q6g =6ACME 


CREATIVE GRAPHICS 
of Kansas 


“What can we create for you?” 


1911 N. Elm 33rd & I-35 
TOPEKA WICHITA 


Call us toll free 1-800-555-5309! 


To create this logo, follow these steps: 


1. Draw the logo on a piece of paper, roughly figuring how large you want each part of the logo to be 
(as well as color and point size). 
F 2. Decide what “type” of Feature each part of the logo is. 
3. Enter the Feature values into Disk Graphics. 


Here are the displays on how you might create the logo: 


DRAW A BOX 
LOWER-LEFT COORDINATES 


A [C@aeaieal 

¥ [COOOa0] 
COLOR CO] 
PITCH CO] 
HEIGHT COe1ida)] 
WIDTH C@8211] 
SHADING CO] 


TEXT STRING 
START COORDINATES 


¥ [80188] 
Y [CO@81a2] 
COLOR CO] 
Slee C2 
c DIRECTION B13 
TEAT 
CACME J 


7S 
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START COORDINATES 


vi 
ran 


vf 
i 


COLOR 
8 A 
DIRECTION 
TEAT 
C "WHE 


TEXT STRING 


[C@aea2z6o] 
[CQ@aasea] 
CO] 
[CO] 
Fad 


START COORDINATES 


vi 
Fs 


Vf 
i 


COLOR 
894 
DIRECTION 
TEAT 
[TOPEKA 


| 
TEXT STRING 


[@8e29] 
[C@8e2e] 
CO] 
[@] 
Le 


START COORDINATES 


7 
fs 


ve 
| 


COLOR 
SIZE 
DIRECTION 
TEXT 

[i9ii N. EDM 


TEXT STRING 
START COORDINATES 


\f 
i 


| COLOR 

Be SIZE 

| DIRECTION 
| TEXT 

| [WICHITA 


[CQA820) 
[22030] 
[CO] 
CO] 
Ci] 


[@G155] 
[CO@OG20] 
CO] 
CO] 
ee 


TEAT STRING 
START COORDINATES 
A Caeidd] 
[88030] 
COLOR [CO] 
Size CO] 
DIRECTION Lid 


TEXT STRING 


START COORDINATES 
Mi [20015] 


¥ [00008] 
COLOR [0] 
SIZE [0] 
DIRECTION cil 
TEXT 


TEXT STRING 
START COORDINATES 
¥ [C@aeis] 
¥ [88080] 
COLOR CO] 
ole bas 
DIRECTION Lad 
eas 
CCREATIVE GRAPHICS 


TEXT STRING 
START COORDINATES 


v7 

fy 

\s 
i 


COLOR 
Si 2e 


DIRECTION 


ttn 


[80070] 
[80065] 
[@] 
ae 
Ci] 


fas 
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DRAW A BOX 
LOWER-LEFT COORDINATES 


V 
Pas 


\e 
i 


COLOR 
PITCH 
HE TGHT 
WIDTH 
SHADING 


DRAW A BOA 
LOWER-LEFT COORDINATES 


v7 
ra 


Vv 
i 


COLOR 
PiLTCH 
HEIGHT 
WIDTH 
SHADING 


DRAW A BOX 
LOWER-LEFT COORDINATES 


Ve 

fy 

Ve 
i 


COLOR 
PITCH 
HET GHT 
WIDTH 
SHADING 


DRAW A BOX 
LOWER-LEFT COORDINATES 


Ve 
ey 


\e 
I 


COLOR 
PITCH 
HEIGHT 
WIDTH 
SHADING 


[22030] 
C2Pigad 
CO] 
CO] 
[aaei5] 
[20010] 
CO] 


[@204d5] 
[OG1aea) 
CO] 
CO] 
[COOOiS] 
[Ooi] 
CO] 


[@eeace] 
CO01ieel 
[8] 
CO] 
CO@Oeis] 
[C@adieal 
[CO] 


[@8e4d5] 
CO@G11ia) 
[CO] 
CO] 
C@8ois] 
[80818] 
C8] 


DRAW A BOX 
LOWER-LEFT 


i 
" 


Ve 
I 


COLOR 
ae Bee 
HEIGHT 
WIDTH 
SHADING 


COORDINATES 


DRAW SEPARATE LINE 
START COORDINATES 


Vi 
fs 


vf 
I 


COORDINATES 


Ve 
Fs 


Vf 
1 


COLOR 
PITCH 


DRAW SEPARATE LINE 
START COORDINATES 


vi 
ra 


ve 
i 


END COORDINATES 


Vf 
"y 


Ve 
i 


COLOR 
P21 iCr 


[00010] 
[22000] 
CO] 
CO] 
[2d140] 
[COe2i11] 
CO] 


CA2ddiG) 
C2d040] 


Cae219] 
C2040) 
CO] 
CO] 


[OO810] 
C2deiGI 


[aa219] 
C2eodiGI 
CO] 
CO] 
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Appendix D/ Disk Data Formats 


If you wish to read or write disk or tape files with a BASIC program, these are the things you will need 
to know. It assumes an advanced knowledge of programming and is somewhat technical. 


General 


All tape files written by this program are ASCII files. (Tape files include a leader on every block. 
Output tape blocks are never more than 128 bytes in length; however, input files may contain up to 
255 bytes per block.) 


The same technique is used when reading and writing both types of files (definitions or features). It is 
a hybrid technique that allows both binary and ASCII data to be written to the same diskette or tape 
file (feature files contain binary data). Basically, it consists of writing as if it were a binary file, but 
with a hex OD character inserted after every byte. With a little effort, BASIC can both read and write 
compatible files. 


This must be taken into account when reading and writing these files. To read such a file, every 
INPUT statement will yield a single character string. Ifa or (ENTER) is read, BASIC will see a null 
string. In this case, a second INPUT must be done. 


When writing such a file, each character must be printed separately. A PRINT CHR$(10) or PRINT 
CHR$(13) must be followed by a simple PRINT statement. 


Although this may sound involved, simple subroutines can be used to read or write a string using 
FOR X=1 TO STRLEN A$ and the MID$ statements. (Look at the sample program in Appendix E 
and it will soon become clear to you how such subroutines are utilized.) 


Chart Definition Files 


A definition file basically contains a list of the keystrokes that would have to be typed in order to 
create the chart by hand. The first character is the response to the TYPE OF CHART menu. This is 
followed by the title, etc. At the end of each item, there is a downarrow character (10 decimal or “OA” 
hex). After the last item of a data display, there is an character (13 decimal). 


Bear in mind the recording technique discussed above. Every character mentioned here is followed by a 
OD hex, including (ENTER) characters. ((ENTER) is recorded as two consecutive (ENTER) characters.) 


Definition files also contain a few other control bytes. The ENTER byte synchronizes the processing of 
each data input display. However, after a series of the same type of display where the number of 
occurrences is variable (such as entering PERIOD labels), a special SYNC byte is inserted (254 
decimal, FE hex). This allows the program to respond correctly when you change the number of 
periods, for example. This SYNC byte is also used after the last data input screen for each period for 
bar charts, since each period can contain a variable number of bars. 


Finally, the chart definition is terminated by a 255 decimal (FF hex) byte. When encountered, any 
additional keystrokes required to define a chart must come from the keyboard. (In fact, when starting a 
new chart definition, you are actually “revising” a previous definition that consists of only a 255 
decimal byte.) 
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Feature Files 


Features are stored in the work files in binary and recorded in your disk or tape files as described. 
There are 10 types of features. Their internal formats are as follows: 


Type 1 — remarks 


Byte 0 = 01 hex (feature type) 
Bytes 1-n = any length text string up to 255 bytes 
Last byte = OD hex 


Type 2 — set defaults 


Byte 0 = 02 type 

Byte 1 = 00-03 point color 
Byte 2 = 00-09 point size 
Byte 3 = 00-03 line color 
Byte 4 = 00-09 line pitch 


Type 3 — draw a box 


Byte 0 = 03 type 

Bytes 1-2 = X-coordinate of lower-left corner 
Bytes 3-4 = Y-coordinate of lower-left corner 
Byte 5 = 00-03 box color 

Byte 6 = 00-09 pitch 

Bytes 7-8 = box height 

Bytes 9-10 = box width 

Byte 11 = 00-01 shaded (1 = shaded) 


Type 4 — text string 


Byte 0 = 04 type 
Bytes 1-2 = starting X-coordinate 
| Bytes 3-4 = starting Y-coordinate 
| Byte 5 = 00-03 color 
Byte 6 = 00-09 size 
Byte 7 = 00-03 direction 
Bytes 8-n = text string (up to 255 characters) 
Last byte = OD 


Type 5 — draw a point 


Byte 0 = 05 type 
Bytes 1-2 = X-coordinate of center 
Bytes 3-4 = Y-coordinate of center 


Type 6 — draw a line continuation 


Byte 0 = 06 type 
Bytes 1-2 = X-coordinate of destination 
Bytes 3-4 = Y-coordinate of destination 
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Type 7 — draw a discrete line 


Byte 0 = 07 type 

Bytes 1-2 = X-coordinate of starting location 
Bytes 3-4 = Y-coordinate of starting location 
Bytes 5-6 = X-coordinate of ending location 
Bytes 7-8 = Y-coordinate of ending location 
Byte 9 = 00-03 color 

Byte 10 = 00-09 pitch 


Type 8 — define a circle 


Byte 0 = 08 type 

Bytes 1-2 = X-coordinate of center 

Bytes 3-4 = Y-coordinate of center 

Bytes 5-6 = 0001-00FF radius 

Bytes 7-8 = 000-0167 (359 decimal) starting angle 


Type 9 — draw an arc 


Byte 0 = 09 type 

Bytes 1-2 = 0000-0168 (360) degrees 
Byte 3 = 00-03 color 

Bytes 4-5 = 0000-00FF offset 

Byte 6 = 00-01 shaded 


Type 0 — end of features 
Byte 0 = 00 type 


Data Compatibility Between Disk and ROM Versions 


Data stored by Disk Graphics on tape AND disk are in the same format as the ROM version of Graphic | 
(26-3157). All Chart Definitions stored on tape with the ROM program can be loaded into the disk | 
program. 


Even though the disk program asks for more data for each point on Line Charts, Line Chart 
Definitions created with the ROM program will still load and work properly. The reverse, however, is 
not true. A Line Chart Definition created with the disk program will not work in the ROM program 
unless the item values are repeated in the MINIMUM prompt. (The ROM program will attempt to 
“enter” all three values with a between them. This will result in “beeps” for the extra C)’s and the 
last value entered, MINIMUM, will end up being the value used.) 


Point Chart Definitions should not be saved on tape for use in the ROM program. However, the Point 
Chart’s Features can be saved on tape and will produce the same results if loaded into the ROM | 
program! The same applies to MAX/MIN Line Charts. | 
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Appendix E/ Sample Program 


The following program is stored on the program diskette as “BASDEF/BAS”. Its output is 
“BASDEF/DEF” which is usable by Disk Graphics. Lines 60 through 300 are standard output 
routines to include in any BASIC program that writes a Chart Definition file. The Point Chart 
created by this program is illustrated below. 


BASIC RRND FUNCTION 


pi 100 , , 


NUM BE 


* 
« 
* 
* 
a 
- 
. * 
* . 
*, “ 
e, 
< 
. 
= 
x 


S 
fb 
S 
S 
PJ 
= 
S 
OJ 
S 
= 


PRS 


SECOND NUMBER 


1D REMHH HHH KKKKKHHHE HEHEHE KKK KKKHKEEEESE 
20 REM*® SAMPLE PROGRAM THAT CREATES A 
3@ REM* POINT CHART FROM GENERATED DATA 
AD REMHHHHHEHEKEHKKKKKKKHHEHE HEHE HEHEHE 
Y@ GOTO 1800 

G62 REM* OUTPUT ROUTINE FOR A NUMBER 
7®@ REM* GIVEN: I 

100 GOSUB 110:2%$=21%:GOTO 200 

105 *REM*EDIT I INTO THE STRING: 21% 
110 21$="" 

115 TL=INT(I/10):1T2=1-11#18:T=11 

120 ZI$=CHRS$(12+48)+21% 

130 IF I + ® THEN 115 

140 RETURN 

150 REM* OUTPUT ROUTINE FOR TEXT 

16@ REM* GIVEN:2% ("?3" INDICATES DOWNARROW 
200 FOR Z=1TOLEN(2$) 

210 Z1I$=MID$(2$52+1):GOSUB 250:NEAT 2 
220 IF ASC(21%)2253 THEN RETURN 

2390 21$="":GOSUB 250:RETURN 

290 IF 21$="3" THEN Zis=CHRS(10) 

eee IF 2iS="" THEN GOSUS 272 

260 REM THIS IS THE ONLY PRINT STMT 
270 PRINT#1+21$:RETURN 

280 REM* SEND SYNC BYTE 
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290 

295 

388 

JOO 

J1¢ 

J20 

I330 

100 
1012 
1820 
1030 
1840 
1050 
1060 
1061 
1070 
1080 
1090 
1100 
1119 
1120 
1130 
1140 
115@ 
1160 


Z£1$=CHRS$(254):GOTO 200 
REM* SEND EOF BYTE 
2l1$=CHR$(255):GOTO 200 
REM 
REMHXHE ER HKKKHEE EK KKEREKHKEEHKKEEE 
REM USER PROGRAM LOGIC STARTS HERE 
REMHEHKKEKKKE KKK KKK EKKEHKEEKHEESE 


CLS:PRINT "GENERATING CHART" 


OPEN 


"O" +#1>"BASDEF/DEF" 


REM DEFINE THE BASICS | 
<$="GBASIC RND FUNCTION":GOSUB 200 


2$="FIRST NUMBER 


SECOND NUMBER 1@0":GOSUB 20¢ 


REM GENERATE 188 POINTS 
FOR N=1i TO 100 
PRINT @ 128 5N5 


AL=RND (30000) :X=INT(X1/100):Y=X1-X#100 
=A3GOSUB 110:REM CHG TO TEXT 
2$=21% 


=¥:GOSUB 118 
REM COMBINE FOR SCREEN DATA STRING 
LSS CSE" >" 4214 
GOSUB 20¢ 
NEXT N 
GOSUB 300: REM SEND EOF BYTE 


CLOSE 
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